Udostępnij za pośrednictwem

Set-SCVMConfiguration

  • Odwołanie
Moduł:
VirtualMachineManager

Modyfikuje konfigurację maszyny wirtualnej dla warstwy komputera.

Składnia

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>]

Opis

Polecenie cmdlet Set-SCVMConfiguration modyfikuje konfigurację maszyny wirtualnej dla warstwy komputera. Konfiguracja maszyny wirtualnej opisuje sposób konfigurowania maszyny wirtualnej podczas wdrażania usługi.

Przykłady

Przykład 1. Aktualizowanie konfiguracji maszyny wirtualnej dla warstwy maszyny przed wdrożeniem usługi

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"

Pierwsze polecenie pobiera obiekt konfiguracji usługi o nazwie Service01 i przechowuje obiekt w zmiennej $ServiceConfig.

Drugie polecenie pobiera konfigurację warstwy komputera dla konfiguracji usługi przechowywanej w $ServiceConfig i przechowuje obiekt w zmiennej $TierConfig.

Trzecie polecenie pobiera konfigurację maszyny wirtualnej dla konfiguracji warstwy komputera przechowywanej w $TierConfig i przechowuje zmienną w zmiennej $VMConfig.

Ostatnie polecenie ustawia właściwość description pierwszego obiektu konfiguracji maszyny wirtualnej przechowywanego w $VMConfig i wyświetla właściwości konfiguracji maszyny wirtualnej dla użytkownika.

Przykład 2. Konfigurowanie obiektu konfiguracji maszyny wirtualnej dla warstwy maszyny w celu przypięcia hosta dla maszyny wirtualnej

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

Pierwsze polecenie pobiera obiekt konfiguracji usługi o nazwie Service01 i przechowuje obiekt w zmiennej $ServiceConfig.

Drugie polecenie pobiera obiekt konfiguracji warstwy komputera dla konfiguracji usługi przechowywanej w $ServiceConfig i przechowuje obiekt w zmiennej $TierConfig.

Trzecie polecenie pobiera obiekty konfiguracji maszyny wirtualnej dla konfiguracji warstwy komputera przechowywanej w $TierConfig i przechowuje obiekty w zmiennej $VMConfig.

Ostatnie polecenie ustawia propety PinVMHost na $True dla pierwszego obiektu konfiguracji maszyny wirtualnej przechowywanego w $VMConfig. W związku z tym po wdrożeniu usługi host maszyny wirtualnej utworzonej przy użyciu tej konfiguracji nie zostanie zmieniony.

Przykład 3. Konfigurowanie obiektu konfiguracji maszyny wirtualnej dla usługi w chmurze prywatnej

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"

Pierwsze polecenie pobiera obiekt konfiguracji usługi o nazwie Service01 i przechowuje obiekt w zmiennej $ServiceConfig.

Drugie polecenie pobiera konfigurację warstwy komputera dla konfiguracji usługi przechowywanej w $ServiceConfig i przechowuje obiekt w zmiennej $TierConfig.

Trzecie polecenie pobiera obiekty konfiguracji maszyny wirtualnej dla konfiguracji warstwy komputera przechowywanej w $TierConfig i przechowuje obiekty w zmiennej $VMConfig.

Czwarte polecenie pobiera obiekt chmury prywatnej o nazwie Production i przechowuje obiekt w zmiennej $Cloud.

Ostatnie polecenie aktualizuje opis drugiego obiektu konfiguracji maszyny wirtualnej przechowywanego w $VMConfig dla chmury prywatnej przechowywanej w $Cloud.

Parametry

-AvailabilitySetNames

Określa listę nazw zestawów dostępności.

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

-CapabilityProfile

Określa obiekt profilu możliwości.

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

-Cloud

Określa obiekt chmury prywatnej.

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

-ComputerName

Określa nazwę komputera, który program Virtual Machine Manager (VMM) może jednoznacznie zidentyfikować w sieci. Prawidłowe formaty to:

  • Nazwa FQDN
  • Adres IPv4 lub IPv6
  • Nazwa NetBIOS
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CostCenter

Określa centrum kosztów dla maszyny wirtualnej, aby można było zbierać dane dotyczące alokacji maszyn wirtualnych (lub zasobów przydzielonych do maszyn wirtualnych), które mają być używane w systemie rozliczeniowym.

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

-Description

Określa opis konfiguracji.

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

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.

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

-Name

Określa nazwę obiektu programu VMM.

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

-NoConnectedHost

Usuwa hosta z konfiguracji maszyny wirtualnej.

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

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet ustawia w imieniu użytkownika jako użytkownika, który ten parametr określa.

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

-OnBehalfOfUserRole

Określa rolę użytkownika. To polecenie cmdlet ustawia rolę użytkownika w imieniu użytkownika jako rolę użytkownika, którą określa ten parametr. Aby uzyskać obiekt roli użytkownika, użyj polecenia cmdlet Get-SCUserRole .

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

-PinVMHost

Wskazuje, czy host maszyny wirtualnej wybrany przez użytkownika jest zachowywany podczas konfiguracji wdrażania usługi.

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

-PinVMLocation

Wskazuje, czy lokalizacja maszyny wirtualnej wybrana przez użytkownika jest zachowywana podczas konfigurowania wdrożenia usługi.

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

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

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

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

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

-Tag

Określa wyraz lub frazę do skojarzenia z obiektem, aby można było wyszukać wszystkie obiekty z określonym zestawem tagów. Możesz wyszukać podzbiór tagów lub wyszukać pełny zestaw tagów.

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

-VMConfiguration

Określa obiekt konfiguracji maszyny wirtualnej.

Type:BaseVMConfiguration
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHost

Określa obiekt hosta maszyny wirtualnej. Program VMM obsługuje hosty funkcji Hyper-V, hosty VMware ESX i hosty Citrix XenServer.

Aby uzyskać więcej informacji na temat każdego typu hosta, zobacz polecenie cmdlet Add-SCVMHost .

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

-VMHostGroup

Określa obiekt grupy hostów maszyny wirtualnej lub tablicę obiektów grupy hostów.

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

-VMLocation

Określa ścieżkę do maszyny wirtualnej.

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

-VMMServer

Określa obiekt serwera programu VMM.

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

Dane wyjściowe

VMConfiguration

To polecenie cmdlet zwraca obiekt VMConfiguration .