Set-SCVMConfiguration

Modul:
VirtualMachineManager Module

Ändert die Konfiguration des virtuellen Computers für eine Computerebene.

Syntax

Update (Standardwert) 

Set-SCVMConfiguration
    [-VMConfiguration] <BaseVMConfiguration>
    [-VMLocation <String>]
    [-PinVMLocation <Boolean>]
    [-ComputerName <String>]
    [-PinVMHost <Boolean>]
    [-CapabilityProfile <CapabilityProfile>]
    [-VMMServer <ServerConnection>]
    [-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>]

VMHost 

Set-SCVMConfiguration
    [-VMConfiguration] <BaseVMConfiguration>
    -VMHost <Host>
    [-VMLocation <String>]
    [-PinVMLocation <Boolean>]
    [-ComputerName <String>]
    [-PinVMHost <Boolean>]
    [-CapabilityProfile <CapabilityProfile>]
    [-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>]

VMHostGroup 

Set-SCVMConfiguration
    [-VMConfiguration] <BaseVMConfiguration>
    [-VMLocation <String>]
    [-PinVMLocation <Boolean>]
    [-ComputerName <String>]
    [-PinVMHost <Boolean>]
    [-VMHostGroup <HostGroup>]
    [-CapabilityProfile <CapabilityProfile>]
    [-VMMServer <ServerConnection>]
    [-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>]

Cloud 

Set-SCVMConfiguration
    [-VMConfiguration] <BaseVMConfiguration>
    -Cloud <Cloud>
    [-VMLocation <String>]
    [-PinVMLocation <Boolean>]
    [-ComputerName <String>]
    [-PinVMHost <Boolean>]
    [-CapabilityProfile <CapabilityProfile>]
    [-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

Mit dem Cmdlet Set-SCVMConfiguration wird die Konfiguration des virtuellen Computers für eine Computerebene geändert. Die Konfiguration des virtuellen Computers beschreibt, wie der virtuelle Computer konfiguriert wird, wenn der Dienst bereitgestellt wird.

Beispiele

Beispiel 1: Aktualisieren der VM-Konfiguration für eine Computerebene vor dem Bereitstellen 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 mit dem Namen Service01 ab und speichert das Objekt in der Variablen $ServiceConfig.

Der zweite Befehl ruft die Konfiguration der Computerebene für die in $ServiceConfig gespeicherte Dienstkonfiguration ab und speichert das Objekt in der Variablen $TierConfig.

Mit dem dritten Befehl wird die Konfiguration des virtuellen Computers für die in $TierConfig gespeicherte Konfiguration der Computerebene abgerufen und die Variable in der Variablen $VMConfig gespeichert.

Mit dem letzten Befehl wird die description-Eigenschaft des ersten Konfigurationsobjekts der virtuellen Maschine festgelegt, das in $VMConfig gespeichert ist, und dem Benutzer werden die Eigenschaften der VM-Konfiguration angezeigt.

Beispiel 2: Konfigurieren des Konfigurationsobjekts des virtuellen Computers für eine Computerebene, um den Host für einen virtuellen Computer anzuheften

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

Der erste Befehl ruft das Dienstkonfigurationsobjekt mit dem Namen Service01 ab und speichert das Objekt in der Variablen $ServiceConfig.

Der zweite Befehl ruft das Konfigurationsobjekt auf Computerebene für die in $ServiceConfig gespeicherte Dienstkonfiguration ab und speichert das Objekt in der Variablen $TierConfig.

Mit dem dritten Befehl werden die Konfigurationsobjekte des virtuellen Computers für die in $TierConfig gespeicherte Konfiguration der Computerebene abgerufen und in der Variablen $VMConfig gespeichert.

Mit dem letzten Befehl wird die Eigenschaft PinVMHost für das erste Konfigurationsobjekt des virtuellen Computers, das in $VMConfig gespeichert ist, auf $True festgelegt. Daher wird bei der Bereitstellung des Diensts der Host für den virtuellen Computer, der mit dieser Konfiguration erstellt wurde, nicht geändert.

Beispiel 3: Konfigurieren des Konfigurationsobjekts des virtuellen Computers 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 mit dem Namen Service01 ab und speichert das Objekt in der Variablen $ServiceConfig.

Der zweite Befehl ruft die Konfiguration der Computerebene für die in $ServiceConfig gespeicherte Dienstkonfiguration ab und speichert das Objekt in der Variablen $TierConfig.

Mit dem dritten Befehl werden die Konfigurationsobjekte des virtuellen Computers für die in $TierConfig gespeicherte Konfiguration der Computerebene abgerufen und in der Variablen $VMConfig gespeichert.

Der vierte Befehl ruft das Private Cloud-Objekt mit dem Namen Production ab und speichert das Objekt in der Variablen $Cloud.

Mit dem letzten Befehl wird die Beschreibung für das zweite Konfigurationsobjekt der virtuellen Maschine aktualisiert, das in $VMConfig für die in $Cloud gespeicherte private Cloud gespeichert ist.

Parameter

-AvailabilitySetNames

Gibt eine Liste der Namen von Verfügbarkeitsgruppen an.

Parametereigenschaften

Typ:

System.Collections.Generic.List`1[System.String]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CapabilityProfile

Gibt ein Funktionsprofilobjekt an.

Parametereigenschaften

Typ:CapabilityProfile
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Cloud

Gibt ein privates Cloud-Objekt an.

Parametereigenschaften

Typ:Cloud
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Cloud
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ComputerName

Gibt den Namen eines Computers an, den Virtual Machine Manager (VMM) in Ihrem Netzwerk eindeutig identifizieren kann. Gültige Formate sind:

  • FQDN (vollqualifizierter Domainname)
  • IPv4- oder IPv6-Adresse
  • NetBIOS-Name

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CostCenter

Gibt die Kostenstelle für eine virtuelle Maschine an, damit Sie Daten über die Zuordnung von virtuellen Maschinen (oder Ressourcen, die virtuellen Maschinen zugeordnet sind) erfassen können, die in Ihrem Abrechnungssystem verwendet werden sollen.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Description

Gibt eine Beschreibung für die Konfiguration an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen eines VMM-Objekts an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-NoConnectedHost

Entfernt den Host aus einer VM-Konfiguration.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUser

Gibt den Namen eines Benutzers an. Dieses Cmdlet legt den Benutzer im Auftrag des Benutzers als Benutzer fest, den dieser Parameter angibt.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Mit diesem Cmdlet wird die Im Auftrag der Benutzerrolle als Benutzerrolle festgelegt, die dieser Parameter angibt. Verwenden Sie zum Abrufen eines Benutzerrollenobjekts das cmdlet Get-SCUserRole.

Parametereigenschaften

Typ:UserRole
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PinVMHost

Gibt an, ob der vom Benutzer ausgewählte Host der virtuellen Maschine während der Konfiguration der Dienstbereitstellung beibehalten wird.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PinVMLocation

Gibt an, ob der vom Benutzer ausgewählte Speicherort des virtuellen Computers während der Konfiguration der Dienstbereitstellung beibehalten wird.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Tag

Gibt ein Wort oder einen Ausdruck an, das bzw. der einem Objekt zugeordnet werden soll, sodass Sie nach allen Objekten mit dem angegebenen Satz von Tags suchen können. Sie können nach einer Teilmenge von Tags suchen, oder Sie können nach dem vollständigen Satz von Tags suchen.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMConfiguration

Gibt ein Konfigurationsobjekt für eine virtuelle Maschine an.

Parametereigenschaften

Typ:BaseVMConfiguration
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMHost

Gibt ein Hostobjekt für eine virtuelle Maschine an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

Weitere Informationen zu den einzelnen Hosttypen finden Sie unter dem Cmdlet Add-SCVMHost .

Parametereigenschaften

Typ:Host
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

VMHost
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMHostGroup

Gibt ein Hostgruppenobjekt einer virtuellen Maschine oder ein Array von Hostgruppenobjekten an.

Parametereigenschaften

Typ:HostGroup
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

VMHostGroup
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMLocation

Gibt den Pfad zu einem virtuellen Computer an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Parametereigenschaften

Typ:ServerConnection
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Update
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
VMHostGroup
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

VMConfiguration

Dieses Cmdlet gibt ein VMConfiguration-Objekt zurück.