Freigeben über


Set-SCVMNetwork

Ändert ein Netzwerk eines virtuellen Computers.

Syntax

Set-SCVMNetwork
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-VMNetwork] <VMNetwork>
   [-Name <String>]
   [-Description <String>]
   [-Owner <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Set-SCVMNetwork ändert die Eigenschaften eines Netzwerks eines virtuellen Computers.

Verwenden Sie zum Abrufen eines zu aktualisierenden Netzwerksobjekts eines virtuellen Computers das cmdlet Get-SCVMNetwork.

Wenn Sie weitere Informationen zu Netzwerken virtueller Computer wünschen, geben Sie Get-Help New-SCVMNetwork -Detailedein.

Beispiele

Beispiel 1: Hinzufügen einer Beschreibung zu einem Virtuellen Computernetzwerk

PS C:\> Get-SCVMNetwork -Name "VMNetwork01" | Set-SCVMNetwork -Description "The first VM network"

Dieser Befehl ruft das Netzwerkobjekt des virtuellen Computers mit dem Namen VMNetwork01 mithilfe des cmdlets Get-SCVMNetwork ab und verwendet dann den Pipelineoperator, um das Objekt an Set-SCVMNetworkzu übergeben, wodurch die Beschreibung für das Netzwerkobjekt des virtuellen Computers geändert wird.

Parameter

-Description

Gibt eine Beschreibung für ein Netzwerk eines virtuellen Computers an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines VMM-Objekts (Virtual Machine Manager) an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole. Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Owner

Gibt den Besitzer eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an.

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PortACL

Gibt eine Portzugriffssteuerungsliste (ACL) an.

Typ:PortACL
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemovePortACL

Gibt an, dass dieser Vorgang die Port-ACL entfernt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserRole

Gibt ein Benutzerrollenobjekt an.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMNetwork

Gibt ein Netzwerkobjekt für virtuelle Computer an.

Um ein Netzwerkobjekt eines virtuellen Computers abzurufen, verwenden Sie das Cmdlet Get-SCVMNetwork.

Typ:VMNetwork
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False