次の方法で共有


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 より大きい設定のみ取得します。