Partager via


Set-SCNATConnection

Met à jour une connexion NAT.

Syntaxe

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>]

Description

L’applet de commande Set-SCNATConnection met à jour une connexion NAT (Network Address Translation).

Exemples

Exemple 1 : Modifier le nom et la description de la connexion NAT d’un réseau de machines virtuelles

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"

La première commande obtient le réseau de la machine virtuelle par son nom et le stocke dans la variable $VmNetwork.

La deuxième commande obtient la connexion NAT pour le réseau de machine virtuelle et la stocke dans la variable $NatConnection.

La troisième commande modifie le nom de connexion NAT en NatConn_VMNAT1 et sa description en connexion NAT pour vm Network1.

Exemple 2 : Modifier l’état de la connexion NAT d’un réseau de machines virtuelles

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

La première commande obtient le réseau de la machine virtuelle par son nom et le stocke dans la variable $VmNetwork.

La deuxième commande obtient la connexion NAT pour le réseau de machine virtuelle et la stocke dans la variable $NatConnection.

La troisième commande modifie l’état de connexion NAT en désactivé.

Paramètres

-Description

Spécifie une description de la connexion NAT.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JobVariable

Spécifie une variable dans laquelle la progression du travail est suivie et stockée.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaximumBandwidthInboundKbps

Spécifie, en kbits/s, la bande passante entrante maximale.

Type:UInt64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaximumBandwidthOutboundKbps

Spécifie, en kbits/s, la bande passante sortante maximale.

Type:UInt64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom d’un objet réseau.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NATConnection

Spécifie un objet de connexion NAT.

Type:NATConnection
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-OnBehalfOfUser

Spécifie un nom d’utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet Get-SCUserRole. Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

Type:UserRole
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Status

Spécifie un état de connexion de passerelle. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Erreur
  • Activé
  • Handicapé
Type:GatewayConnectionStatus
Valeurs acceptées:Error, Enabled, Disabled
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMMServer

Spécifie un objet serveur VMM (Virtual Machine Manager).

Type:ServerConnection
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False