Remove-CsAllowedDomain
トピックの最終更新日: 2012-03-26
フェデレーションが承認されているドメインのリストからドメインを削除します。
構文
Remove-CsAllowedDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
フェデレーションは、2 つの組織が組織間のコミュニケーションを促進する信頼関係を設定できるようにするための手段です。フェデレーションが確立されると、2 つの組織のユーザーはインスタント メッセージの送受信やプレゼンス通知の登録ができ、Microsoft Lync 2010 のような SIP アプリケーションを使用して互いに通信することもできます。Microsoft Lync Server 2010 では、次の 3 種類のフェデレーションが可能です。1) 自組織と他組織間の直接フェデレーション、2) 自組織と公開プロバイダー間のフェデレーション、3) 自組織とサードパーティ ホスティング プロバイダー間のフェデレーション。
他組織との直接フェデレーションを設定するには、複数の操作が必要です。まず、フェデレーションを許可するために、サーバーで Lync Server アクセス エッジ サービスの実行を有効にする必要があります。次に、相手組織側で自組織とのフェデレーションを有効にする必要があります。双方の組織がこの関係に合意していないと、フェデレーションを確立することはできません。
フェデレーション設定を確立するために、2 つのフェデレーション関連リストを管理する必要が生じることもあります。許可リストおよび禁止リストです。許可リストは、フェデレーションの相手として選んだ組織の一覧です。許可リストにドメインがある場合、(構成設定によっては) 自組織のユーザーはフェデレーション相手のドメインのアカウントを持つユーザーとインスタント メッセージやプレゼンス情報を交換できます。逆に、禁止リストは、ユーザーが明示的にフェデレーションを禁止したドメインの一覧です。たとえば、禁止されたドメインから送信されたメッセージは、自動的に Lync Server 2010 によって拒否されます。
フェデレーション関係を停止する場合、Remove-CsAllowedDomain コマンドレットを使用して、許可されたドメインのリストから該当するドメインを削除します。その後、必要な場合は、New-CsBlockedDomain を使用して、禁止されたドメインのリストにドメインを追加します。単一のドメインが許可リストと禁止リストの両方に同時に存在できないことに注意してください。
このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーが Remove-CsAllowedDomain コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsAllowedDomain"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
文字列 |
許可リストから削除するドメインの完全修飾ドメイン名 (FQDN)、たとえば、"fabrikam.com"。ドメインの ID を指定するときはワイルドカードを使用できません。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain オブジェクト。Remove-CsAllowedDomain は、許可されたドメイン オブジェクトに関する、パイプ処理されたインスタンスを受け入れます。
戻り値の種類
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain オブジェクトのインスタンスを削除します。
例
-------------------------- 例 1 ------------------------
Remove-CsAllowedDomain -Identity fabrikam.com
例 1 のコマンドを実行して、許可されたドメインのリストから fabrikam.com というドメインを削除しています。
-------------------------- 例 2 ------------------------
Get-CsAllowedDomain -Filter *fabrikam* | Remove-CsAllowedDomain
例 2 では、許可されたドメインのリストから、ID の任意の場所に "fabrikam" という文字列を持つすべてのドメインを削除しています。これを行うために、コマンドでまず Get-CsAllowedDomain と Filter パラメーターを使用して、Identity (Identity はフィルター処理することができる唯一のプロパティ) の任意の場所に "fabrikam" という文字列を持つドメインのコレクションを戻します。そのフィルター処理したコレクションを Remove-CsAllowedDomain にパイプ処理し、次に、許可されたドメインのリストから、フィルター処理したコレクション内のすべての項目を削除します。
-------------------------- 例 3 ------------------------
Get-CsAllowedDomain | Where-Object {$_.ProxyFqdn -eq $Null} | Remove-CsAllowedDomain
例 3 では、許可されたドメインのリストから、識別されるプロキシ サーバーがないすべてのドメインを削除しています。このタスクを実行するために、Get-CsAllowedDomain を呼び出して、許可リストに現在含まれているすべてのドメインのコレクションを戻します。そのコレクションを Where-Object コマンドレットにパイプ処理し、ProxyFqdn プロパティが NULL 値と等しいドメインのみ取得されます。そのフィルター処理したコレクションを Remove-CsAllowedDomain にパイプ処理し、許可リストからコレクション内の各ドメインを削除します。
-------------------------- 例 4 ------------------------
Get-CsAllowedDomain | Where-Object {$_.Comment -match "Ken Myer"} | Remove-CsAllowedDomain
上記の例では、許可されたドメインのリストから、Comment フィールドに "Ken Myer" という文字列が含まれているすべてのドメインを削除しています。これを行うために、コマンドでまず Get-CsAllowedDomain を使用し、許可されたドメインのリストに現在含まれているすべてのドメインのコレクションを取得します。このコレクションを Where-Object コマンドレットにパイプ処理し、Comment プロパティに "Ken Myer" という文字列が含まれているドメインのみ取得します。このフィルター処理したコレクションを Remove-CsAllowedDomain にパイプ処理し、許可されたドメインのリストからコレクション内の各項目を削除します。