Get-CsNetworkConfiguration
トピックの最終更新日: 2012-03-23
通話受付管理 (CAC)、Enhanced 9-1-1 (E9-1-1)、およびメディア バイパスのグローバル設定を取得します。
構文
Get-CsNetworkConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
ネットワーク構成オブジェクトには、メディア バイパスのすべてのグローバル設定と、その構成が有効になっているかどうかなど、Microsoft Lync Server 2010 展開内の CAC 構成全体のすべてのグローバル設定が格納されています。このコマンドレットを使用して、これらの構成と設定を取得できます。ただし、EnableBandwidthPolicyCheck と MediaBypassSettings 以外で CAC 構成設定を取得するためには、オブジェクト型に固有なコマンドレットを使用することをお勧めします。たとえば、ネットワーク地域を取得するためには、通常、Get-CsNetworkConfiguration を呼び出すよりも、Get-CsNetworkRegion を呼び出して、その構成の NetworkRegions プロパティを取得するほうが簡単です。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Get-CsNetworkConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsIdentity |
この値は常に Global にする必要があります。 |
Filter |
省略可能 |
文字列 |
1 つのネットワーク構成のみ存在するため、このコマンドレットではこのパラメーターは必要ありません。 |
LocalStore |
省略可能 |
SwitchParameter |
中央管理ストア 自体ではなく、中央管理ストア のローカル レプリカからネットワーク構成を取得します。 |
入力の種類
なし。
戻り値の種類
Get-CsNetworkConfiguration を実行すると、Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings オブジェクトのインスタンスが戻されます。
例
-------------------------- 例 1 --------------------------
Get-CsNetworkConfiguration
この例では、ネットワーク構成設定を取得します。これらの設定はグローバル スコープでのみ定義されているため、1 つの項目のみ戻されます。
-------------------------- 例 2 --------------------------
(Get-CsNetworkConfiguration).MediaBypassSettings
グローバルに適用されるメディア バイパス設定のセットが 1 つのみ存在します。これらの設定は、ネットワーク構成全体の一部として格納されています。このコマンドでまず、Get-CsNetworkConfiguration を呼び出してその構成を取得し、構成の MediaBypassSettings プロパティを取得します。