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 Netzwerkadressenübersetzungsregel (NAT) hinzu.

Beispiele

Beispiel1: 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 virtuelle Computernetzwerk nach seinem Namen ab und speichert ihn in der $VmNetwork Variable.

Der zweite Befehl ruft NAT-Verbindung für das virtuelle Computernetzwerk ab und speichert sie in der $NatConnection Variable.

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.

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

-InternalIPAddress

Gibt eine interne IP-Adresse an.

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

-InternalPort

Gibt eine interne Portnummer an.

Type:UInt32
Position:Named
Default value:None
Required:True
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

-Name

Gibt den Namen eines Netzwerkobjekts an.

Type:String
Position:Named
Default value:None
Required:True
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:False
Accept wildcard characters:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag 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. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Auftrag 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 der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die 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

-Protocol

Gibt ein Protokoll an. Zulässige Werte für diesen Parameter:

  • TCP
  • UDP
Type:Protocol
Accepted values:TCP, UDP
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, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-VMMServer

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

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