Get-CsNetworkSubnet
トピックの最終更新日: 2012-03-23
1 つまたは複数のネットワーク サブネットに関する情報を取得します。
構文
Get-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSubnet [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
各サブネットは、そのサブネットに所属するホストの地理的な場所を指定するために、ネットワーク サイトに関連付ける必要があります。このコマンドレットを使用すると、Identity (サブネット ID) を含めたサブネット、マスク ビットの番号、関連付けられたネットワーク サイト、およびサブネットの説明などのサブネットに関する情報を取得できます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Get-CsNetworkSubnet コマンドレットのローカルでの実行を承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkSubnet"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsGlobalRelativeIdentity |
取得するサブネットの一意のサブネット ID。この値は、IP アドレス (174.11.12.0 など) になります。 |
Filter |
省略可能 |
文字列 |
このパラメーターを使用すると、すべてのサブネットを Identity を基にワイルドカード検索できます。たとえば、Filter 値が "172.11.*" の場合、Identity が 172.11 で始まるすべてのサブネットが取得されます(172.11.10.0, 172.11.25.0 など)。 |
LocalStore |
省略可能 |
SwitchParameter |
ネットワーク サブネットの情報を 中央管理ストア そのものからではなく、中央管理ストア のローカル レプリカから取得します。 |
入力の種類
なし。
戻り値の種類
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType 型のオブジェクトを 1 つまたは複数戻します。
例
-------------------------- 例 1 --------------------------
Get-CsNetworkSubnet
この例では、Microsoft Lync Server 2010 展開内のすべてのサブネットを取得します。
-------------------------- 例 2 --------------------------
Get-CsNetworkSubnet -Identity 172.11.15.0
この例では、Identity (サブネット ID) が "172.11.15.0" のサブネットに関するすべての情報を取得します。
-------------------------- 例 3 --------------------------
Get-CsNetworkSubnet -Filter 172.11.*
この例では、ID が "172.11." で始まるすべてのサブネットを取得します。
-------------------------- 例 4 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"}
例 4 では、Vancouver サイトに関連付けられたすべてのサブネットを取得します。まず、例 2 のように、Get-CsNetworkSubnet コマンドレットをパラメーターなしで呼び出して、定義済みのすべてのサブネットを取得します。次に、サブネットのこのコレクションは Where-Object コマンドレットにパイプ処理されます。Where-Object はこのコレクションを取り込んで、NetworkSiteID が Vancouver に等しい (-eq) サブネットのみに絞り込みます。