Sdílet prostřednictvím


Set-SCVMConfiguration

Upraví konfiguraci virtuálního počítače pro úroveň počítače.

Syntax

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 úroveň počítače. Konfigurace virtuálního počítače popisuje, jak se virtuální počítač nakonfiguruje při nasazení služby.

Příklady

Příklad 1: Aktualizace konfigurace virtuálního počítače pro úroveň 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 proměnné $ServiceConfig.

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žené 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 úroveň 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 $True

První příkaz získá objekt konfigurace služby s názvem Service01 a uloží objekt do proměnné $ServiceConfig.

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ého v $VMConfig. Proto při nasazení služby se hostitel virtuálního počítače vytvořeného pomocí této konfigurace 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 proměnné $ServiceConfig.

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 privátního cloudu uloženého v $Cloud.

Parametry

-AvailabilitySetNames

Určuje seznam názvů skupin dostupnosti.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CapabilityProfile

Určuje objekt profilu schopností.

Type:CapabilityProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Cloud

Určuje objekt privátního cloudu.

Type:Cloud
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Určuje název počítače, který může nástroj Virtual Machine Manager (VMM) jednoznačně identifikovat ve vaší síti. Platné formáty jsou:

  • FQDN
  • Adresa IPv4 nebo IPv6
  • Název rozhraní NetBIOS
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CostCenter

Určuje nákladové středisko pro virtuální počítač, abyste mohli shromažďovat data o přidělení virtuálních počítačů (nebo prostředků přidělených virtuálním počítačům) k využití ve fakturačním systému.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Určuje popis konfigurace.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Určuje název objektu VMM.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoConnectedHost

Odebere hostitele z konfigurace virtuálního počítače.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Určuje jméno uživatele. Tato rutina nastaví jménem uživatele jako uživatele, kterého tento parametr určuje.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PinVMHost

Určuje, jestli se hostitel virtuálního počítače zvolený uživatelem zachová během konfigurace nasazení služby.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PinVMLocation

Určuje, jestli se během konfigurace nasazení služby zachová umístění virtuálního počítače zvolené uživatelem.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek vrátil do příkazového prostředí okamžitě.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Určuje slovo nebo frázi, které se mají 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConfiguration

Určuje objekt konfigurace virtuálního počítače.

Type:BaseVMConfiguration
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 .

Type:Host
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMHostGroup

Určuje objekt skupiny hostitelů virtuálního počítače nebo pole objektů skupiny hostitelů.

Type:HostGroup
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMLocation

Určuje cestu k virtuálnímu počítači.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Určuje objekt serveru VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Výstupy

VMConfiguration

Tato rutina vrátí objekt VMConfiguration .