Set-SCNATConnection

Aktualisierungen eine NAT-Verbindung.

Syntax

Set-SCNATConnection
   [-VMMServer <ServerConnection>]
   [-NATConnection] <NATConnection>
   [-Name <String>]
   [-Description <String>]
   [-Status <GatewayConnectionStatus>]
   [-MaximumBandwidthInboundKbps <UInt64>]
   [-MaximumBandwidthOutboundKbps <UInt64>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-SCNATConnection aktualisiert eine Netzwerkadressenübersetzung (NAT)-Verbindung.

Beispiele

Beispiel 1: Ändern des Namens und der Beschreibung für die NAT-Verbindung eines virtuellen Computernetzwerks

PS C:\> $VmNetwork = Get-SCVMNetwork -Name "NAT_VMNetwork"
PS C:\> $NatConnection = Get-SCNATConnection -VMNetwork $VmNetwork
PS C:\> Set-SCNATConnection -NATConnection $NatConnection -Name "NatConn_VMNAT1" -Description "NAT Connection for VM Network1"

Der erste Befehl ruft das Netzwerk des virtuellen Computers anhand seines Namens ab und speichert es in der $VmNetwork Variablen.

Der zweite Befehl ruft NAT-Verbindung für das Netzwerk des virtuellen Computers ab und speichert sie in der $NatConnection Variablen.

Der dritte Befehl ändert den NAT-Verbindungsnamen in NatConn_VMNAT1 und seine Beschreibung in NAT-Verbindung für VM Network1.

Beispiel 2: Ändern des Status für die NAT-Verbindung eines virtuellen Computernetzwerks

PS C:\> $VmNetwork = Get-SCVMNetwork -Name "NAT_VMNetwork"
PS C:\> $NatConnection = Get-SCNATConnection -VMNetwork $VmNetwork
PS C:\> Set-SCNATConnection -NATConnection  $NatConnection -Status Disabled"

Der erste Befehl ruft das Netzwerk des virtuellen Computers anhand seines Namens ab und speichert es in der $VmNetwork Variablen.

Der zweite Befehl ruft NAT-Verbindung für das Netzwerk des virtuellen Computers ab und speichert sie in der $NatConnection Variablen.

Der dritte Befehl ändert den NAT-Verbindungsstatus in "Deaktiviert".

Parameter

-Description

Gibt eine Beschreibung für die NAT-Verbindung an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumBandwidthInboundKbps

Gibt in KBit/s die maximale eingehende Bandbreite an.

Type:UInt64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumBandwidthOutboundKbps

Gibt in KBit/s die maximale ausgehende Bandbreite an.

Type:UInt64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Gibt den Namen eines Netzwerkobjekts an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NATConnection

Gibt ein NAT-Verbindungsobjekt an.

Type:NATConnection
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, 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. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Type:UserRole
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

-Status

Gibt einen Gatewayverbindungsstatus an. Zulässige Werte für diesen Parameter:

  • Fehler
  • Aktiviert
  • Disabled
Type:GatewayConnectionStatus
Accepted values:Error, Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Gibt ein VMM-Serverobjekt (Virtual Machine Manager) an.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False