Remove-CsWebServiceConfiguration
トピックの最終更新日: 2012-03-26
Web サービス 構成設定の 1 つ以上のコレクションを削除します。
構文
Remove-CsWebServiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
多くの Microsoft Lync Server 2010 コンポーネントは Web ベースです。これらのコンポーネントでは、Web サービスまたは Web ページのいずれかを使用してタスクを実行します。たとえば、新しい連絡先をアドレス帳で検索したり、グループ拡張を使用して配布グループの個々のメンバーを表示したりする場合に、ユーザーは Web サービスを使用します。同様に、ダイヤルイン会議から Microsoft Lync Server 2010 コントロール パネル までにわたる各種コンポーネントは、Web ページを Lync Server 2010 とユーザー間のインターフェイスとして使用します。
CsWebServiceConfiguration コマンドレットを使用すると、管理者は組織全体で Web サービス 構成設定を管理できるようになります。これには、グループ拡張、証明書の設定、および許可された認証方法の管理が含まれます。グローバル スコープ、サイト スコープ、およびサービス スコープで異なる設定を構成できるため (Web Services サービスの場合のみ)、さまざまなユーザーや場所に合わせて Web サービス の機能をカスタマイズできます。
サイト スコープまたはサービス スコープでカスタムの Web サービス 構成設定を作成する場合、Remove-CsWebServiceConfiguration コマンドレットを使用してこれらの設定を後で削除できます。また、Web サービス 設定のグローバル コレクションで Remove-CsWebServiceConfiguration を実行することもできます。ただしこの場合、Lync Server ではグローバル設定を削除できないため、グローバル コレクションは削除されません。代わりに、グローバル コレクションのすべてのプロパティが既定値に戻ります。たとえば、MaxGroupSizeToExpand の値を 500 に変更したとします。このプロパティの既定値は 100 であるため、グローバル コレクションを "削除" すると、MaxGroupSizeToExpand プロパティの値は 100 にリセットされます。
このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーが、Remove-CsWebServiceConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsWebServiceConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
Xds Identity |
削除する Web サービス 構成設定の一意の識別子。サイト スコープで構成されている設定を削除するには、次のような構文を使用します。-Identity "site:Redmond"。サービス スコープで構成されている設定を削除するには、次のような構文を使用します。-Identity "service:WebServer:atl-cs-001.litwareinc.com"。 Remove-CsWebServiceConfiguration も、グローバル コレクションで実行できます。ただしこの場合、グローバル コレクションは削除されません。代わりに、そのコレクションのプロパティが既定値にリセットされます。グローバル コレクションをリセットするには、次の構文を使用します。-Identity global。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings オブジェクト。Remove-CsWebServiceConfiguration は、Web サービス 設定オブジェクトのパイプ処理された入力を受け入れます。
戻り値の種類
なし。代わりに、Remove-CsWebServiceConfiguration を実行すると、Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings オブジェクトの既存のインスタンスが削除されます。
例
-------------------------- 例 1 ------------------------
Remove-CsWebServiceConfiguration -Identity site:Redmond
上記のコマンドは、レドモンド サイトの Web サービス 構成設定を削除します。
-------------------------- 例 2 ------------------------
Get-CsWebServiceConfiguration -Filter "site:*" | Remove-CsWebServiceConfiguration
例 2 では、サイト スコープで構成されているすべての Web サービス 設定を削除します。このタスクを実行するために、コマンドでまず Get-CsWebServiceConfiguration を呼び出して Filter パラメーターを使用します。フィルター値 "site:*" を指定することで、"site:" という文字で始まる ID を持つ設定のみが返されます。このフィルター処理したコレクションを Remove-CsWebServiceConfiguration にパイプ処理し、コレクション内の各項目を削除します。
-------------------------- 例 3 ------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.EnableGroupExpansion -eq $False} | Remove-CsWebServiceConfiguration
例 3 のコマンドは、グループ拡張が無効になっているすべての Web サービス 構成設定を削除します。これを行うために、組織で使用されているすべての Web サービス 構成設定のコレクションを戻すよう、コマンドでまず、パラメーターを指定せずに Get-CsWebServiceConfiguration を呼び出します。このコレクションを Where-Object コマンドレットにパイプ処理し、EnableGroupExpansion プロパティが False と等しい設定のみ取得します。フィルター処理したコレクションを Remove-CsWebServiceConfiguration にパイプ処理し、コレクション内の各項目を削除します。