1. OG_VM-Report

    Článek: AN0001780Aktualizováno:: 22.04.2020

    Tato funkce vrátí seznam virtuálních strojů s danými vlastnostmi z vCenter serverů dle konfigurace.

    Hlavní předpoklady pro použití 

    Předpoklad Popis
    Powershell remoting Při komunikaci s externími systémy využívajícími vykonání Powershell příkazů externím systémem je třeba na externím systému povolit remoting.
    vCenter Reader Role pro čtení dat z VMware vCenter.
    Práva na službu WinRM Při komunikaci s externími systémy využívajícími vykonání Powershell příkazů externím systémem je třeba účtu odesílajícímu příkaz přidělit práva na remoting.
    Powershell v3 Microsoft Powershell verze 3 nebo vyšší.

    Popis

    Funkce vytvoří textový soubor obsahující informace o virtuálních strojích dle konfigurace. Soubor obsahuje následující informace.

     

    Název hlavičky sloupce Popis
    VMName Název virtuálního stroje ve Vcenter.
    GuestShortName Název virtuálního stroje.
    GuestDomain Název domény tohoto stroje.
    GuestFQDN FQDN stroje.
    GuestOS Operační systém stroje.
    GuestIP IP adresa/adresy stroje.
    DC Název Datacentra ve vCenter.
    Cluster Název Clusteru ve vCenter.
    HostName Název ESX serveru, na němž se stroj aktuálně nachází.
    VMNotes Poznámky ke stroji ve vCenter.
    VMNumCPU Počet CPU přidělených stroji.
    VMMemoryGB Počet GB RAM přidělených stroji.
    VMUsedSpaceGB Prostor na discích použítých strojem v GB.
    VMProvisionedSpaceGB Prostor na discích přidělený stroji v GB.
    VMMacAddress MAC adresa stroje.
    VMPowerState Stav virtuálního stroje (PoweredOn/PoweredOff).
    ToolsVersion Verze VMware tools.
    ToolsStatus Status VMware tools.
    ToolsVersionStatus Status verze VMware tools.
    ToolsRunningStatus Status běhu VMware tools.
    VMXLocation Umístění VMX souboru.
    VMDKLocation Umístění VMDK souboru.
    Volitelné sloupce Ve výstupním souboru mohou být další sloupce s hodnotami dle parametru $VMCustParams.

    Parametry

    Níže uvedené parametry uveďte v souboru og_configuration.ps1 (obecné parametry sdílené s jinými funkcemi) nebo v souboru OG_VMReport-1.0.config (konkrétní parametry této funkce). Konfigurace parametrů je obecně popsána v dokumentaci programu Piklo.

     

    Parametr Popis Příklad
    [string]$OutFile Cesta k souboru, v němž má být uložen výstup funkce.

    [string]$ExportFile = "\\yourserver\data\OG-output\VM-Report.txt"
    [string]$LogFile Cesta k souboru, v němž má být uložen log funkce.

    [string]$LogFile = "\\yourserver\data\OG-output\VM-Report_Log.txt"
    [string]$OutEnc Kódování výstupního souboru. Možné volby jsou "UTF8", "Unicode" a "DEFAULT". Hodnota "DEFAULT" způsobí vytvoření souboru v kódování ANSI.

    [string]$OutFileEncoding = "UTF8"
    [string]$Delimiter Oddělovač hodnot v záznamech. Možné hodnoty jsou: "t" - tabulator, ";" - středník a "," - čárka

    [string]$Delimiter = "t"
    [string]$HeaderOutFile Určuje, zda má výstupní soubor obsahovat hlavičku s názvy sloupců ("1") nebo ne ("0").

    [string]$HeaderOutFile = "1"

    [string]$HeaderOutFile = "1"

    		 Cesta k pracovnímu adresáři.

    [string]$WorkFilePath = "\\servername\OGtemp"
    [array]$vCenterServers Pole se servery vCenter, které budou dotazovány. ("vcenter1.yourdomain.com","vcenter2.yourdomain.com")
    [string]$VMNotes Určuje, zda má výstupní soubor obsahovat hodnoty VMNotes ("1") nebo ne ("0"). [string]$VMNotes = "1"
    [array]$VMCustParams Pole s vlastními parametry definovanými ve vCenter zákazníkem. ("DRPriorioty","CreatedBy")
    [string]$VMOnlyRunningTools Určuje, zda má výstupní soubor obsahovat pouze servery, na nichž běží tools ("1") nebo ne ("0"). U serverů, na nichž běží tools, lze získat informace z virtuálního stroje. [string]$VMOnlyRunningTools = "1"

    Volání

    Funkce je volána pomocí programu Piklo, který je součástí balíku ObjectGears, ze skriptu ObjectGears. Výsledek volání je třeba přiřadit do proměnné, se kterou lze ve skriptu dále pracovat.

    a = OG.Process.RunPiklo('OG_VMReport-1.0','-type C')

    V tomto článku
    ×