Set-NetConnectionProfile

Set-NetConnectionProfile

Changes the network category of a connection profile.

Syntaxe

Parameter Set: Query (cdxml)
Set-NetConnectionProfile [-AsJob] [-CimSession <CimSession[]> ] [-InterfaceAlias <String[]> ] [-InterfaceIndex <UInt32[]> ] [-IPv4Connectivity <IPv4Connectivity[]> ] [-IPv6Connectivity <IPv6Connectivity[]> ] [-Name <String[]> ] [-NetworkCategory <NetworkCategory> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Set-NetConnectionProfile -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-NetworkCategory <NetworkCategory> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Description détaillée

The Set-NetConnectionProfile cmdlet changes the network category setting of a connection profile. A connection profile represents a network connection.

Paramètres

-AsJob

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

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

Alias

Session

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-InputObject<CimInstance[]>

Spécifie l’entrée de cette applet de commande. Vous pouvez utiliser ce paramètre ou transmettre l’entrée à cette applet de commande.

Alias

none

Obligatoire ?

true

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

True (ByValue)

Accepter les caractères génériques ?

false

-InterfaceAlias<String[]>

Specifies an array of names of network adapters.

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

True (ByPropertyName)

Accepter les caractères génériques ?

false

-InterfaceIndex<UInt32[]>

Specifies an array of numerical index values associated with the network adapters.

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

True (ByPropertyName)

Accepter les caractères génériques ?

false

-IPv4Connectivity<IPv4Connectivity[]>

Specifies an array of IPv4 protocol connectivity status values. Les valeurs acceptables pour ce paramètre sont :
-- Disconnected
-- NoTraffic
-- Subnet
-- LocalNetwork
-- Internet

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-IPv6Connectivity<IPv6Connectivity[]>

Specifies an array of IPv6 protocol connectivity status values. Les valeurs acceptables pour ce paramètre sont :
-- Disconnected
-- NoTraffic
-- Subnet
-- LocalNetwork
-- Internet

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Name<String[]>

Specifies an array of names of networks with which the connection is currently established.

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-NetworkCategory<NetworkCategory>

Specifies an array of category types of a network. You cannot set the DomainAuthenticated type by using this cmdlet. The server automatically sets the value of DomainAuthenticated when the network is authenticated to a domain controller. Les valeurs acceptables pour ce paramètre sont :
-- Public
-- Private

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

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

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

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

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Confirm

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

Obligatoire ?

false

Position ?

named

Valeur par défaut

false

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

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

Obligatoire ?

false

Position ?

named

Valeur par défaut

false

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<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 (http://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.

Sorties

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

Exemples

Example 1: Change the network category of a connection profile

This example changes the network category of a connection profile.

This first command gets the connection profile for the network adapter named Ethernet1. The command stores the results in the $Profile variable.

PS C:\> $Profile = Get-NetConnectionProfile -InterfaceAlias Ethernet1

This second command assigns the value of Public to the NetworkCategory property of the connection profile stored in the $Profile variable.

PS C:\> $Profile.NetworkCategory = Public

This third command sets the network category of the connection profile stored in the $Profile variable.

PS C:\> Set-NetConnectionProfile -InputObject $Profile

Rubriques connexes

Get-NetConnectionProfile