Remove-CsSipDomain
トピックの最終更新日: 2012-03-27
組織で使用するように以前に構成された SIP ドメインを削除します。SIP ドメインは、SIP トラフィックの送受信を承認されたドメインのことで、SIP アドレスをユーザーに割り当てるときに使用されます。
構文
Remove-CsSipDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
ユーザーの SIP アドレスを構成するには (またこのために、ユーザーが Microsoft Lync 2010 などの SIP 関連ソフトウェアを使用できるようにするには)、次の 2 つの情報が必要です。ユーザー ID (Ken Myer など) と SIP ドメイン (litwareinc.com など) です。SIP アドレスを構成するのに使用する SIP ドメインは、Active Directory フォレスト内にあるドメインであり、SIP トラフィックの送受信が承認済みである必要があります。たとえば、litwareinc.com、fabrikam.com、および contoso.com というドメインがあるが、litwareinc.com だけが SIP ドメインとして識別されているとします。この場合、少なくとも fabrikam.com と contoso.com を有効な SIP ドメインとして構成するまでは、sip:Ken.Myer@fabrikam.com や sip:Ken.Myer@contoso.com のような SIP アドレスは使用できません。New-CsSipDomain コマンドレットを実行してこれを行います。
SIP ドメインを承認した後、Remove-CsSipDomain コマンドレットを使用してこれを "未承認" にできます。このコマンドレットは、指定されたドメインを承認済みの SIP ドメインのリストから削除します。ただし、既定のドメインは削除できないことに注意してください。これを行う必要がある場合、最初に他の SIP ドメインを構成して既定のドメインとして機能させる必要があります。SIP ドメインが 1 つしかない場合、このドメインが自動的に既定のドメインとして構成されるため、これを削除することはできません。
さらに、1 つまたは複数の SIP アドレスが割り当てられているどの SIP ドメインも削除できません。たとえば、Ken Myer が "sip:kenmyer@contoso.com" という SIP アドレスを所有している場合は、SIP ドメインである Contoso.com を削除できません。現在使用中の SIP ドメインを削除するには、自らの SIP アドレスの中でそのドメインを使用しているすべてのユーザーに対して、新しい SIP アドレスを割り当てる必要があります。
このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーが Remove-CsSipDomain コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsSipDomain"}
パラメーター
パラメーター | 必須 | 型 | 説明 |
---|---|---|---|
Identity |
必須 |
文字列 |
削除する SIP ドメインの完全修飾ドメイン名 (FQDN)。次に例を示します。-Identity fabrikam.com。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.Xds.SipDomain オブジェクト。Remove-CsSipDomain は、SIP ドメイン オブジェクトに関する、パイプ処理されたインスタンスを受け入れます。
戻り値の種類
なし。代わりに、Remove-CsSipDomain は、Microsoft.Rtc.Management.Xds.SipDomain オブジェクトの既存のインスタンスを削除します。
例
-------------------------- 例 1 ------------------------
Remove-CsSipDomain -Identity fabrikam.com
上記のコマンドを実行すると、fabrikam.com という ID の SIP ドメインが、サポートされるドメイン名のリストから削除されます。fabrikam.com が組織で現在使用中の唯一の SIP ドメインである場合、このコマンドは失敗することに注意してください。トポロジには少なくとも 1 つの SIP ドメインを含める必要があるためです。
-------------------------- 例 2 ------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -ne $True} | Remove-CsSipDomain
例 2 に示すコマンドを実行すると、既定のドメイン以外の組織のすべての SIP ドメインが削除されます。これを行うために、このコマンドでは最初に、Get-CsSipDomain を呼び出して、すべての SIP ドメインのコレクションを戻します。次に、このコレクションを Where-Object コマンドレットにパイプ処理し、IsDefault プロパティが True と等しくないドメインのみを選び出します。結果として、既定のドメインがフィルター処理され、次に、残りのドメインは Remove-CsSipDomain にパイプ処理され、削除されます。