Freigeben über


Add-SCNATRule

Fügt eine NAT-Regel hinzu.

Syntax

Add-SCNATRule
   [-VMMServer <ServerConnection>]
   [-NATConnection] <NATConnection>
   -Name <String>
   -InternalIPAddress <String>
   -ExternalPort <UInt32>
   -InternalPort <UInt32>
   [-Protocol <Protocol>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Add-SCNATRule fügt eine NAT-Regel (Network Address Translation) hinzu.

Beispiele

Beispiel 1: Hinzufügen einer NAT-Regel zu einem Virtuellen Computernetzwerk für einen virtuellen Computer

PS C:\> $VmNetwork = Get-SCVMNetwork -Name "NAT_VMNetwork"
PS C:\> $NatConnection = Get-SCNATConnection -VMNetwork $VmNetwork
PS C:\> Add-SCNATRule -NATConnection $NatConnection -ExternalPort 8081 -InternalIPAddress 10.10.10.9 -InternalPort 8081 -Protocol "TCP" -Name "NatRule"

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

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

Der dritte Befehl erstellt eine NAT-Regel mit dem Namen NatRule, eine interne IP-Adresse des virtuellen Computers 10.10.10.9, einen internen Port 8081, einen externen Port 8081 und das Protokoll TCP.

Parameter

-ExternalPort

Gibt eine externe Portnummer an.

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

-InternalIPAddress

Gibt eine interne IP-Adresse an.

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

-InternalPort

Gibt eine interne Portnummer an.

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

-JobVariable

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

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

-Name

Gibt den Namen eines Netzwerkobjekts an.

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

-NATConnection

Gibt ein NAT-Verbindungsobjekt an.

Typ:NATConnection
Position:0
Standardwert:None
Erforderlich:True
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

-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

-Protocol

Gibt ein Protokoll an. Die zulässigen Werte für diesen Parameter sind:

  • TCP
  • UDP
Typ:Protocol
Zulässige Werte:TCP, UDP
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

-VMMServer

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

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