Set-SCVMConfiguration
Upraví konfiguraci virtuálního počítače pro úroveň počítače.
Syntaxe
Set-SCVMConfiguration
[-VMLocation <String>]
[-PinVMLocation <Boolean>]
[-ComputerName <String>]
[-PinVMHost <Boolean>]
[-CapabilityProfile <CapabilityProfile>]
[-VMMServer <ServerConnection>]
[-VMConfiguration] <BaseVMConfiguration>
[-Description <String>]
[-Tag <String>]
[-CostCenter <String>]
[-Name <String>]
[-NoConnectedHost]
[-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Set-SCVMConfiguration
[-VMLocation <String>]
[-PinVMLocation <Boolean>]
[-ComputerName <String>]
-VMHost <Host>
[-PinVMHost <Boolean>]
[-CapabilityProfile <CapabilityProfile>]
[-VMConfiguration] <BaseVMConfiguration>
[-Description <String>]
[-Tag <String>]
[-CostCenter <String>]
[-Name <String>]
[-NoConnectedHost]
[-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Set-SCVMConfiguration
[-VMLocation <String>]
[-PinVMLocation <Boolean>]
[-ComputerName <String>]
[-PinVMHost <Boolean>]
[-VMHostGroup <HostGroup>]
[-CapabilityProfile <CapabilityProfile>]
[-VMMServer <ServerConnection>]
[-VMConfiguration] <BaseVMConfiguration>
[-Description <String>]
[-Tag <String>]
[-CostCenter <String>]
[-Name <String>]
[-NoConnectedHost]
[-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Set-SCVMConfiguration
[-VMLocation <String>]
[-PinVMLocation <Boolean>]
[-ComputerName <String>]
[-PinVMHost <Boolean>]
-Cloud <Cloud>
[-CapabilityProfile <CapabilityProfile>]
[-VMConfiguration] <BaseVMConfiguration>
[-Description <String>]
[-Tag <String>]
[-CostCenter <String>]
[-Name <String>]
[-NoConnectedHost]
[-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Description
Rutina Set-SCVMConfiguration upraví konfiguraci virtuálního počítače pro vrstvu počítače. Konfigurace virtuálního počítače popisuje způsob konfigurace virtuálního počítače při nasazení služby.
Příklady
Příklad 1: Aktualizace konfigurace virtuálního počítače pro vrstvu počítače před nasazením služby
PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -Description "This is the updated virtual machine configuration"První příkaz získá objekt konfigurace služby s názvem Service01 a uloží objekt do $ServiceConfig proměnné.
Druhý příkaz získá konfiguraci úrovně počítače pro konfiguraci služby uloženou v $ServiceConfig a uloží objekt do proměnné $TierConfig.
Třetí příkaz získá konfiguraci virtuálního počítače pro konfiguraci vrstvy počítače uloženou v $TierConfig a uloží proměnnou do proměnné $VMConfig.
Poslední příkaz nastaví vlastnost popisu prvního objektu konfigurace virtuálního počítače uloženého v $VMConfig a zobrazí vlastnosti konfigurace virtuálního počítače uživateli.
Příklad 2: Konfigurace objektu konfigurace virtuálního počítače pro vrstvu počítače pro připnutí hostitele virtuálního počítače
PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -PinVMHost $TruePrvní příkaz získá objekt konfigurace služby s názvem Service01 a uloží objekt do $ServiceConfig proměnné.
Druhý příkaz získá objekt konfigurace vrstvy počítače pro konfiguraci služby uložené v $ServiceConfig a uloží objekt do proměnné $TierConfig.
Třetí příkaz získá objekty konfigurace virtuálního počítače pro konfiguraci vrstvy počítače uložené v $TierConfig a uloží objekty do proměnné $VMConfig.
Poslední příkaz nastaví PinVMHost propety na $True pro první objekt konfigurace virtuálního počítače uložený v $VMConfig. Proto při nasazení služby se hostitel virtuálního počítače vytvořeného s touto konfigurací nezmění.
Příklad 3: Konfigurace objektu konfigurace virtuálního počítače pro službu v privátním cloudu
PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $Cloud = Get-SCCloud -Name "Production"
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[1] -Cloud $Cloud -Description "This is the new virtual machine configuration"První příkaz získá objekt konfigurace služby s názvem Service01 a uloží objekt do $ServiceConfig proměnné.
Druhý příkaz získá konfiguraci úrovně počítače pro konfiguraci služby uloženou v $ServiceConfig a uloží objekt do proměnné $TierConfig.
Třetí příkaz získá objekty konfigurace virtuálního počítače pro konfiguraci vrstvy počítače uložené v $TierConfig a uloží objekty do proměnné $VMConfig.
Čtvrtý příkaz získá objekt privátního cloudu s názvem Production a uloží objekt do proměnné $Cloud.
Poslední příkaz aktualizuje popis druhého objektu konfigurace virtuálního počítače uloženého v $VMConfig pro privátní cloud uložený v $Cloud.
Parametry
-AvailabilitySetNames
Určuje seznam názvů skupin dostupnosti.
| Typ: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-CapabilityProfile
Určuje objekt profilu schopností.
| Typ: | CapabilityProfile |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Cloud
Určuje objekt privátního cloudu.
| Typ: | Cloud |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ComputerName
Určuje název počítače, který může nástroj Virtual Machine Manager (VMM) jedinečně identifikovat v síti. Platné formáty jsou:
- FQDN
- Adresa IPv4 nebo IPv6
- Název rozhraní NetBIOS
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-CostCenter
Určuje nákladové středisko pro virtuální počítač, abyste mohli shromažďovat data o přidělování virtuálních počítačů (nebo prostředků přidělených virtuálním počítačům) pro využití ve fakturačním systému.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Description
Určuje popis konfigurace.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-JobVariable
Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Name
Určuje název objektu VMM.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-NoConnectedHost
Odebere hostitele z konfigurace virtuálního počítače.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-OnBehalfOfUser
Určuje jméno uživatele. Tato rutina nastaví jménem uživatele jako uživatele, který určuje tento parametr.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-OnBehalfOfUserRole
Určuje roli uživatele. Tato rutina nastaví roli uživatele jménem uživatele jako roli uživatele, kterou tento parametr určuje. K získání objektu role uživatele použijte rutinu Get-SCUserRole.
| Typ: | UserRole |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PinVMHost
Určuje, jestli se hostitel virtuálního počítače zvolený uživatelem zachová během konfigurace nasazení služby.
| Typ: | Boolean |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PinVMLocation
Určuje, jestli je umístění virtuálního počítače zvolené uživatelem zachováno během konfigurace nasazení služby.
| Typ: | Boolean |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PROTipID
Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.
| Typ: | Guid |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-RunAsynchronously
Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Tag
Určuje slovo nebo frázi, které chcete přidružit k objektu, abyste mohli vyhledat všechny objekty se zadanou sadou značek. Můžete vyhledat podmnožinu značek nebo můžete vyhledat úplnou sadu značek.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-VMConfiguration
Určuje objekt konfigurace virtuálního počítače.
| Typ: | BaseVMConfiguration |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-VMHost
Určuje objekt hostitele virtuálního počítače. Nástroj VMM podporuje hostitele Hyper-V, hostitele VMware ESX a hostitele Citrix XenServer.
Další informace o jednotlivých typech hostitelů najdete v rutině Add-SCVMHost.
| Typ: | Host |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-VMHostGroup
Určuje objekt skupiny hostitelů virtuálního počítače nebo pole objektů skupiny hostitelů.
| Typ: | HostGroup |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-VMLocation
Určuje cestu k virtuálnímu počítači.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-VMMServer
Určuje objekt serveru VMM.
| Typ: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Výstupy
VMConfiguration
Tato rutina vrátí objekt VMConfiguration.