Get-NetConnectionProfile

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.

パラメーター

-AsJob

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。既定値は、ローカル コンピューターで実行中の現在のセッションです。

-InterfaceAlias<String[]>

Specifies an array of names of network adapters.

-InterfaceIndex<UInt32[]>

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

-IPv4Connectivity<IPv4Connectivity[]>

Specifies an array of IPv4 protocol connectivity status values. このパラメーターに対して使用できる値:
-- Disconnected
-- NoTraffic
-- Subnet
-- LocalNetwork
-- Internet

-IPv6Connectivity<IPv6Connectivity[]>

Specifies an array of IPv6 protocol connectivity status values. このパラメーターに対して使用できる値:
-- Disconnected
-- NoTraffic
-- Subnet
-- LocalNetwork
-- Internet

-Name<String[]>

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

-NetworkCategory<NetworkCategory[]>

Specifies an array of category types of a network. このパラメーターに対して使用できる値:
-- Public
-- Private
-- DomainAuthenticated

-ThrottleLimit<Int32>

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Get a connection profile

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