Get-CsWebServiceConfiguration
トピックの最終更新日: 2012-03-23
組織で使用されているすべての Web サービス 構成設定に関する情報を戻します。
構文
Get-CsWebServiceConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsWebServiceConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
多くの Microsoft Lync Server 2010 コンポーネントは Web ベースです。これらのコンポーネントでは、Web サービスまたは Web ページのいずれかを使用してタスクを実行します。たとえば、新しい連絡先をアドレス帳で検索したり、グループ拡張を使用して配布グループの個々のメンバーを表示したりする場合に、ユーザーは Web サービスを使用します。同様に、ダイヤルイン会議から Microsoft Lync Server 2010 コントロール パネル までにわたる各種コンポーネントは、Web ページを Lync Server 2010 とユーザー間のインターフェイスとして使用します。
CsWebServiceConfiguration コマンドレットを使用すると、管理者は組織全体で Web サービス 構成設定を管理できます。これには、グループ拡張、証明書の設定、および許可された認証方法の管理が含まれます。グローバル スコープ、サイト スコープ、およびサービス スコープで異なる設定を構成できるため (ただし、Web Services サービスの場合のみ)、さまざまなユーザーや場所に合わせて Web サービス の機能をカスタマイズできます。
Get-CsWebServiceConfiguration コマンドレットを使用すると、組織で現在使用中の Web サービス 構成設定に関する詳細な情報を戻すことができます。
このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーが、Get-CsWebServiceConfiguration コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsWebServiceConfiguration"}
パラメーター
パラメーター | 必須 | 型 | 説明 |
---|---|---|---|
Identity |
省略可能 |
Xds Identity |
戻される Web サービス 構成設定の一意の識別子。グローバル設定を返すには、次の構文を使用します。-Identity global。サイト スコープで構成された設定を返すには、次のような構文を使用します。-Identity "site:Redmond"。サービス スコープの設定を返すには、次のような構文を使用します。-Identity "service:WebServer:atl-cs-001.litwareinc.com"。 Filter パラメーターと Identity パラメーターの両方を同じコマンドで使用することはできません。どちらのパラメーターも指定しないと、Get-CsWebServiceConfiguration は組織で現在使用されているすべての Web サービス 設定のコレクションを戻します。 |
Filter |
省略可能 |
文字列 |
戻される Web サービス 構成設定のコレクションを指定するときに、ワイルドカードを使用できます。たとえば、次の構文は、サイト スコープで構成されているすべての設定を戻します。-Filter "site:*"。 Filter パラメーターと Identity パラメーターの両方を同じコマンドで使用することはできません。 |
LocalStore |
省略可能 |
スイッチ パラメーター |
中央管理ストア 自体からではなく、中央管理ストア のローカル レプリカから Web サービス 構成のデータを取得します。 |
入力の種類
なし。Get-CsWebServiceConfiguration は、パイプ処理された入力を受け入れません。
戻り値の種類
Get-CsWebServiceConfiguration を実行すると、Microsoft.Rtc.Management.WritableConfig.Web.WebServiceSettings オブジェクトのインスタンスが戻されます。
例
-------------------------- 例 1 ------------------------
Get-CsWebServiceConfiguration
上記のコマンドを実行すると、組織で現在使用されているすべての Web サービス 構成設定に関する情報が戻されます。
-------------------------- 例 2 ------------------------
Get-CsWebServiceConfiguration -Identity site:Redmond
例 2 のコマンドを実行すると、ID が site:Redmond になっている Web サービス 構成設定に関する情報が戻されます。
-------------------------- 例 3 ------------------------
Get-CsWebServiceConfiguration -Filter "site:*"
例 3 では、サイト スコープで割り当てられたすべての Web サービス 構成設定が戻されます。これを行うには、Get-CsWebServiceConfiguration を呼び出すときに Filter パラメーターを指定しています。フィルター値 "site:*" により、ID が文字列値 "site:" で始まる設定のみが返されます。
-------------------------- 例 4 ------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.UsePinAuth -eq $False}
例 4 のコマンドを実行すると、暗証番号 (PIN) 認証を許可しないすべての Web サービス 構成設定が戻されます。これを行うため、まず Get-CsWebServiceConfiguration を呼び出して、現在使用中のすべての Web サービス 構成設定を戻します。このコレクションを Where-Object コマンドレットにパイプ処理して、UsePinAuth プロパティが False と等しい設定のみを選択します。
-------------------------- 例 5 ------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.MaxGroupSizeToExpand -gt 100}
上記のコマンドを実行すると、最大グループ拡張サイズが 100 より大きいすべての Web サービス 構成設定が戻されます。これを行うため、このコマンドはまず Get-CsWebServiceConfiguration を使用して、現在使用されているすべての Web サービス 構成設定を戻します。次に、この情報は Where-Object コマンドレットにパイプ処理され、MaxGroupSizeToExpand プロパティが 100 より大きい設定のみ取得します。