Set-SCVMConfiguration
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 przypinania 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 $TruePierwsze 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.
| Typ: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-CapabilityProfile
Określa obiekt profilu możliwości.
| Typ: | CapabilityProfile |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Cloud
Określa obiekt chmury prywatnej.
| Typ: | Cloud |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ComputerName
Określa nazwę komputera, który program Virtual Machine Manager (VMM) może jednoznacznie zidentyfikować w sieci. Prawidłowe formaty to:
- FQDN
- Adres IPv4 lub IPv6
- Nazwa NetBIOS
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Description
Określa opis konfiguracji.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-JobVariable
Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Name
Określa nazwę obiektu programu VMM.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-NoConnectedHost
Usuwa hosta z konfiguracji maszyny wirtualnej.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-OnBehalfOfUser
Określa nazwę użytkownika. To polecenie cmdlet ustawia w imieniu użytkownika jako użytkownika, który określa ten parametr.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | UserRole |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PinVMHost
Wskazuje, czy host maszyny wirtualnej wybrany przez użytkownika jest zachowywany podczas konfigurowania wdrożenia usługi.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PinVMLocation
Wskazuje, czy lokalizacja maszyny wirtualnej wybrana przez użytkownika jest zachowywana podczas konfiguracji wdrożenia usługi.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | Guid |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-RunAsynchronously
Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-VMConfiguration
Określa obiekt konfiguracji maszyny wirtualnej.
| Typ: | BaseVMConfiguration |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-VMHost
Określa obiekt hosta maszyny wirtualnej. Program VMM obsługuje hosty 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
| Typ: | Host |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-VMHostGroup
Określa obiekt grupy hostów maszyny wirtualnej lub tablicę obiektów grupy hostów.
| Typ: | HostGroup |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-VMLocation
Określa ścieżkę do maszyny wirtualnej.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-VMMServer
Określa obiekt serwera programu VMM.
| Typ: | ServerConnection |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
Dane wyjściowe
VMConfiguration
To polecenie cmdlet zwraca obiekt VMConfiguration.