Get-NetConnectionProfile

Gets a connection profile.

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

The Get-NetConnectionProfile cmdlet gets a connection profile associated with one or more physical network adapters. A connection profile represents a network connection.

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

Specifies an array of names of network adapters.

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

Specifies an array of IPv4 protocol connectivity status values. Die folgenden Werte für diesen Parameter sind zulässig:
-- Disconnected
-- NoTraffic
-- Subnet
-- LocalNetwork
-- Internet

Specifies an array of IPv6 protocol connectivity status values. Die folgenden Werte für diesen Parameter sind zulässig:
-- Disconnected
-- NoTraffic
-- Subnet
-- LocalNetwork
-- Internet

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

Specifies an array of category types of a network. Die folgenden Werte für diesen Parameter sind zulässig:
-- Public
-- Private
-- DomainAuthenticated

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

This first part of this command gets the connection profile for the network adapter named Ethernet1. The command passes the results to the Set-NetConnectionProfile cmdlet by using the pipe operator. The second part of the command changes the value of the network category for the connection profile.

PS C:\> Get-NetConnectionProfile -InterfaceAlias "Ethernet1" | Set-NetConnectionProfile -NetworkCategory Public

Set-NetConnectionProfile