Get-CsNetworkSite
トピックの最終更新日: 2012-03-23
通話受付管理 (CAC) または Enhanced 9-1-1 (E9-1-1) に対して定義されている、1 つまたは複数のネットワーク サイトを取得します。
構文
Get-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSite [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
ネットワーク サイトは、CAC または E9-1-1 展開の各地域内において構成されるオフィスまたは拠点です。このコマンドレットは、1 つまたは複数の既存のサイトの設定を取得します。
このコマンドレットを実行できるユーザー: 既定では、Get-CsNetworkSite コマンドレットをローカルで実行する権限があるのは、RTCUniversalUserAdmins および RTCUniversalServerAdmins グループのメンバーです。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkSite"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsGlobalRelativeIdentity |
取得するネットワーク サイトの一意の識別子です。サイトはグローバル スコープでのみ作成されるため、スコープを指定する必要はありません。その代わりに、サイト ID のみを指定する必要があります (これはネットワーク サイトの NetworkSiteID と同じ値であることに注意してください)。 |
Filter |
省略可能 |
文字列 |
サイトの ID とフィルター値の照合に基づき、複数のサイトを取得できるワイルドカード文字列です。 |
LocalStore |
省略可能 |
SwitchParameter |
ネットワーク サイトの情報を、中央管理ストア 本体からではなく、中央管理ストア のローカル レプリカから取得します。 |
入力の種類
なし。
戻り値の種類
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 型のオブジェクトを取得します。
例
-------------------------- 例 1 --------------------------
Get-CsNetworkSite
Get-CsNetworkSite をパラメーターを指定せずに呼び出すと、CAC または E9-1-1 に対して構成されている、Microsoft Lync Server 2010 展開内のすべてのネットワーク サイトを戻します。
-------------------------- 例 2 --------------------------
Get-CsNetworkSite -Identity Redmond
このコマンドは ID (定義上は NetworkSiteID) が Redmond であるサイトを取得します。
-------------------------- 例 3 --------------------------
Get-CsNetworkSite -Filter NA*
例 3 のコマンドでは、Get-CsNetworkSite に Filter パラメーターを指定して呼び出しています。Filter パラメーターの値が NA* であるため、このコマンドは文字列 NA で始まる任意の文字数の Identity のサイトをすべて取得します。これにより、NARedmond、NAVancouver、または NAChicago のようなサイトが戻されます。
-------------------------- 例 4 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"}
例 4 では、Get-CsNetworkSite および Where-Object の 2 つのコマンドレットを使用して、NorthAmerica 地域に含まれるすべてのサイトを取得します。まず Get-CsNetworkSite をパラメーターを指定せずに呼び出し、すべてのネットワーク サイトを取得します。次に、このサイトのコレクションを Where-Object へパイプ処理し、コレクションをフィルタリングして、NetworkRegionID プロパティが NorthAmerica に等しい (-eq) コレクション内のサイトをすべて探します。