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 virtueller Computer 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 Variablen.
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 Konfiguration der Computerebene ab und speichert die Variable in der $VMConfig Variablen.
Der letzte Befehl legt die Beschreibungseigenschaft des ersten konfigurationsobjekts des virtuellen Computers fest, das in $VMConfig gespeichert ist, und zeigt die Eigenschaften der Konfiguration des virtuellen Computers für den Benutzer an.
Beispiel 2: Konfigurieren des Konfigurationsobjekts für virtuelle Computer 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 Variablen.
Der zweite Befehl ruft das Konfigurationsobjekt der Computerebene für die in $ServiceConfig gespeicherte Dienstkonfiguration ab und speichert das Objekt in der $TierConfig Variablen.
Der dritte Befehl ruft die Konfigurationsobjekte für virtuelle Computer für die in $TierConfig gespeicherte Computerebenenkonfiguration ab und speichert die Objekte in der $VMConfig Variablen.
Der letzte Befehl legt den PinVMHost-Vorgang auf $True für das erste konfigurationsobjekt des virtuellen Computers fest, das in $VMConfig gespeichert ist. Wenn der Dienst bereitgestellt wird, wird der Host für den virtuellen Computer, der mit dieser Konfiguration erstellt wurde, nicht geändert.
Beispiel 3: Konfigurieren des Konfigurationsobjekts für virtuelle Computer 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 Variablen.
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 Konfigurationsobjekte für virtuelle Computer für die in $TierConfig gespeicherte Computerebenenkonfiguration ab und speichert die Objekte in der $VMConfig Variablen.
Der vierte Befehl ruft das private Cloudobjekt mit dem Namen Production ab und speichert das Objekt in der $Cloud Variablen.
Der letzte Befehl aktualisiert die Beschreibung für das zweite Konfigurationsobjekt des virtuellen Computers, 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 der Virtual Machine Manager (VMM) in 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 Konfiguration eines virtuellen Computers.
| 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 Benutzer im 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 die Benutzerrolle im Namen der Benutzerrolle als die Benutzerrolle fest, die dieser Parameter angibt. Verwenden Sie zum Abrufen eines Benutzerrollenobjekts 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 Speicherort des virtuellen Computers während der Konfiguration der Dienstbereitstellung beibehalten wird.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der 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, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.
| 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, damit Sie nach allen Objekten mit dem angegebenen Satz von Tags suchen können. Sie können nach einer Teilmenge von Tags suchen oder nach der vollständigen Gruppe von Tags suchen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMConfiguration
Gibt ein Konfigurationsobjekt für virtuelle Computer 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.