Set-SCVMConfiguration
Ändert die Konfiguration des virtuellen Computers für eine Computerebene.
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>]Beschreibung
Das Cmdlet Set-SCVMConfiguration ändert die Konfiguration des virtuellen Computers für eine Computerebene. Die Konfiguration des virtuellen Computers beschreibt, wie der virtuelle Computer konfiguriert wird, wenn der Dienst bereitgestellt wird.
Beispiele
Beispiel 1: Aktualisieren der Konfiguration des virtuellen Computers für eine Computerebene vor der Bereitstellung des Diensts
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"Der erste Befehl ruft das Dienstkonfigurationsobjekt namens Service01 ab und speichert das Objekt in der $ServiceConfig Variable.
Der zweite Befehl ruft die Computerebenenkonfiguration für die in $ServiceConfig gespeicherte Dienstkonfiguration ab und speichert das Objekt in der $TierConfig Variablen.
Der dritte Befehl ruft die Konfiguration des virtuellen Computers für die in $TierConfig gespeicherte Computerkonfiguration ab und speichert die Variable in der $VMConfig Variable.
Der letzte Befehl legt die Beschreibungseigenschaft des ersten in $VMConfig gespeicherten virtuellen Computerkonfigurationsobjekts fest und zeigt die Eigenschaften der virtuellen Computerkonfiguration für den Benutzer an.
Beispiel 2: Konfigurieren des Virtuellen Computerkonfigurationsobjekts für eine Computerebene zum Anheften des Hosts für einen virtuellen Computer
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 $TrueDer erste Befehl ruft das Dienstkonfigurationsobjekt namens Service01 ab und speichert das Objekt in der $ServiceConfig Variable.
Der zweite Befehl ruft das Computerebenenkonfigurationsobjekt für die in $ServiceConfig gespeicherte Dienstkonfiguration ab und speichert das Objekt in der $TierConfig Variablen.
Der dritte Befehl ruft die virtuellen Computerkonfigurationsobjekte für die in $TierConfig gespeicherte Computerebenenkonfiguration ab und speichert die Objekte in der $VMConfig Variablen.
Der letzte Befehl legt die PinVMHost-Propety auf $True für das erste in $VMConfig gespeicherte virtuelle Computerkonfigurationsobjekt fest. Wenn der Dienst bereitgestellt wird, wird der Host für den virtuellen Computer, der mit dieser Konfiguration erstellt wurde, daher nicht geändert.
Beispiel 3: Konfigurieren des Virtuellen Computerkonfigurationsobjekts für einen Dienst in einer privaten Cloud
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"Der erste Befehl ruft das Dienstkonfigurationsobjekt namens Service01 ab und speichert das Objekt in der $ServiceConfig Variable.
Der zweite Befehl ruft die Computerebenenkonfiguration für die in $ServiceConfig gespeicherte Dienstkonfiguration ab und speichert das Objekt in der $TierConfig Variablen.
Der dritte Befehl ruft die virtuellen Computerkonfigurationsobjekte für die in $TierConfig gespeicherte Computerebenenkonfiguration ab und speichert die Objekte in der $VMConfig Variablen.
Der vierte Befehl ruft das private Cloudobjekt namens Production ab und speichert das Objekt in der $Cloud Variable.
Der letzte Befehl aktualisiert die Beschreibung des zweiten virtuellen Computerkonfigurationsobjekts, das in $VMConfig für die in $Cloud gespeicherte private Cloud gespeichert ist.
Parameter
-AvailabilitySetNames
Gibt eine Liste der Verfügbarkeitssatznamen an.
| Type: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CapabilityProfile
Gibt ein Funktionsprofilobjekt an.
| Type: | CapabilityProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Cloud
Gibt ein privates Cloudobjekt an.
| Type: | Cloud |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
Gibt den Namen eines Computers an, auf dem Virtual Machine Manager (VMM) auf Ihrem Netzwerk eindeutig identifiziert werden kann. Gültige Formate sind:
- FQDN
- IPv4- oder IPv6-Adresse
- NetBIOS-Name
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CostCenter
Gibt die Kostenstelle für eine virtuelle Maschine an, sodass Sie Daten zur Zuordnung virtueller Maschinen (oder zu den den virtuellen Maschinen zugeordneten Ressourcen) sammeln können, um sie im Rechnungssystem zu verwenden.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Gibt eine Beschreibung für die Konfiguration an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Gibt den Namen eines VMM-Objekts an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoConnectedHost
Entfernt den Host aus einer virtuellen Computerkonfiguration.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Gibt den Namen eines Benutzers an. Dieses Cmdlet legt den Namen des Benutzers als Benutzer fest, den dieser Parameter angibt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Gibt eine Benutzerrolle an. Dieses Cmdlet legt den Namen der Benutzerrolle als Benutzerrolle fest, die dieser Parameter angibt. Verwenden Sie zum Abrufen eines Benutzerrolleobjekts das Cmdlet Get-SCUserRole .
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinVMHost
Gibt an, ob der vom Benutzer ausgewählte virtuelle Computerhost während der Dienstbereitstellungskonfiguration beibehalten wird.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinVMLocation
Gibt an, ob der vom Benutzer ausgewählte Virtuelle Computerspeicherort während der Dienstbereitstellungskonfiguration beibehalten wird.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
Gibt ein Wort oder einen Ausdruck an, der einem Objekt zugeordnet werden soll, sodass Sie nach allen Objekten mit der angegebenen Gruppe von Tags suchen können. Sie können nach einer Teilmenge von Tags suchen oder nach dem vollständigen Satz von Tags suchen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMConfiguration
Gibt ein Virtuelles Computerkonfigurationsobjekt an.
| Type: | BaseVMConfiguration |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMHost
Gibt ein Hostobjekt für virtuelle Maschinen an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.
Weitere Informationen zu jedem Hosttyp finden Sie im Add-SCVMHost-Cmdlet .
| Type: | Host |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostGroup
Gibt ein Hostgruppenobjekt für virtuelle Maschinen oder einen Array aus Hostgruppenobjekten an.
| Type: | HostGroup |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMLocation
Gibt den Pfad zu einem virtuellen Computer an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Ausgaben
VMConfiguration
Dieses Cmdlet gibt ein VMConfiguration-Objekt zurück.