Set-NetNat

Set-NetNat

Modifies settings for NAT objects.

Syntaxe

Parameter Set: Query (cdxml)
Set-NetNat [-Name] <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-IcmpQueryTimeout <UInt32> ] [-PassThru] [-TcpEstablishedConnectionTimeout <UInt32> ] [-TcpFilteringBehavior <FilteringBehaviorType> ] [-TcpTransientConnectionTimeout <UInt32> ] [-ThrottleLimit <Int32> ] [-UdpFilteringBehavior <FilteringBehaviorType> ] [-UdpIdleSessionTimeout <UInt32> ] [-UdpInboundRefresh <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Set-NetNat -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-IcmpQueryTimeout <UInt32> ] [-PassThru] [-TcpEstablishedConnectionTimeout <UInt32> ] [-TcpFilteringBehavior <FilteringBehaviorType> ] [-TcpTransientConnectionTimeout <UInt32> ] [-ThrottleLimit <Int32> ] [-UdpFilteringBehavior <FilteringBehaviorType> ] [-UdpIdleSessionTimeout <UInt32> ] [-UdpInboundRefresh <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Description détaillée

The Set-NetNat cmdlet modifies settings for Network Address Translation (NAT) objects. NAT modifies IP address and port information in packet headers. Use this cmdlet to modify the following:

-- Time-out values for ICMP and UDP sessions and TCP connections.
-- Behavior of TCP and UDP filtering.
-- Whether packets from external networks refresh UDP sessions.

Specify NAT objects to modify by using the Name parameter or by using the Get-NetNat cmdlet. Use the New-NetNat cmdlet to create NAT objects.

Paramètres

-AsJob

-CimSession<CimSession[]>

Exécute l’applet de commande dans une session à distance ou sur un ordinateur distant. Entrez un nom d’ordinateur ou un objet de session, comme la sortie d’une applet de commande New-CimSession ou Get-CimSession. La valeur par défaut est la session active sur l’ordinateur local.

-IcmpQueryTimeout<UInt32>

Specifies the length of the time-out period, in seconds, for an ICMP query session.

-InputObject<CimInstance[]>

Specifies an array of NAT objects. To obtain a NAT object, use the Get-NetNat cmdlet or the New-NetNat cmdlet.

-Name<String[]>

Specifies an array of names of NAT objects.

-PassThru

Retourne un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucun résultat.

-TcpEstablishedConnectionTimeout<UInt32>

Specifies the length of the time-out period, in seconds, for established TCP connections. Use the TcpTransientConnectionTimeout parameter to modify the time-out period for transient TCP connections.

-TcpFilteringBehavior<FilteringBehaviorType>

Specifies filtering behavior for TCP connections. Les valeurs acceptables pour ce paramètre sont :

-- EndpointIndepedentFiltering
-- AddressDependentFiltering

The default value is EndpointIndepedentFiltering.

-TcpTransientConnectionTimeout<UInt32>

Specifies the length of the time-out period, in seconds, for transient TCP connections. Use the TcpEstablishedConnectionTimeout parameter to modify the time-out period for established TCP connections.

-ThrottleLimit<Int32>

Spécifie le nombre maximal d’opérations simultanées qui peuvent être établies pour exécuter cette applet de commande. Si ce paramètre est omis ou si la valeur 0 est entrée, Windows PowerShell ® calcule une limitation optimale pour l’applet de commande en fonction du nombre d’applets de commande CIM qui s’exécutent sur l’ordinateur. La limitation s’applique seulement à l’applet de commande actuelle, et non pas à la session ni à l’ordinateur.

-UdpFilteringBehavior<FilteringBehaviorType>

Specifies filtering behavior for UDP sessions. Les valeurs acceptables pour ce paramètre sont :

-- EndpointIndepedentFiltering
-- AddressDependentFiltering

The default value is EndpointIndepedentFiltering.

-UdpIdleSessionTimeout<UInt32>

Specifies the length of the time-out period, in seconds, for a UDP session.

-UdpInboundRefresh<Boolean>

Indicates whether a packet from the external network refreshes an existing UDP session. If you specify a value of $True for this parameter, either an inbound packet or an outbound packet refreshes an existing UDP session. If you specify a value of $False, only an outbound packet refreshes a UDP session. The default value is $False.

-Confirm

Votre confirmation sera requise avant l’exécution de l’applet de commande.

-WhatIf

Présente les conséquences éventuelles de l’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.

• None

Sorties

Le type de sortie est le type des objets émis par l’applet de commande.

• Microsoft.Management.Infrastructure.CimInstance#ROOT/StandardCimv2/MSFT_NetNat

Exemples

Example 1: Modify settings for a NAT object

This command modifies a NAT object named TSQATenant. The command specifies a value of $True for the UdpInboundRefresh parameter, and, therefore, NAT refreshes UDP sessions for both inbound and outbound packets. The command changes TCP filtering behavior to address dependent filtering.

PS C:\> Set-NetNat -Name "TSQATenant" -TcpFilteringBehavior AddressDependentFiltering -UdpInboundRefresh $True 

Rubriques connexes

Get-NetNat

New-NetNat

Remove-NetNat