Set-CsSipDomain
トピックの最終更新日: 2012-03-27
組織内の SIP ドメインのプロパティ値を変更できます。SIP ドメインは、SIP トラフィックの送受信を承認されたドメインのことで、SIP アドレスをユーザーに割り当てるときに使用されます。
構文
Set-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-IsDefault <$true | $false>] [-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 ドメインが 1 つ構成されている必要があります。Set-CsSipDomain コマンドレットを使用して、既定の SIP ドメインを変更できます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Set-CsSipDomain コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSipDomain"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
文字列 |
既定ドメインとして構成される SIP ドメインの完全修飾ドメイン名 (FQDN) です。次に例を示します。-Identity fabrikam.com。 |
IsDefault |
省略可能 |
ブール値 |
ドメイン名が明示的に示されていない場合、ドメインが Lync Server 2010 で使用される既定の SIP ドメインであるかどうかを指定します。True に設定すると、新しいドメインが新しい既定のドメインになります。この値を False に設定することはできません。既定の SIP ドメインがなくなってしまうためです。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
なし。Set-CsSipDomain では、パイプライン処理されたデータを受け入れません。
戻り値の種類
Set-CsSipDomain を実行しても、オブジェクトや値が戻されることはありません。代わりに、このコマンドレットを使用して、Microsoft.Rtc.Management.Xds.SipDomain オブジェクトの既存のインスタンスを変更することができます。
例
-------------------------- 例 1 ------------------------
Set-CsSipDomain -Identity fabrikam.com -IsDefault $True
例 1 のコマンドを実行すると、SIP ドメイン fabrikam.com が既定の SIP ドメインになります。これを行うには、IsDefault パラメーターおよびパラメーター値 $True を使用します。このコマンドを実行すると、Fabrikam.com が既定のドメインになり、以前は既定としてサービスを提供していたドメインは "降格" になります。これは、既定のドメインは 1 つしか存在しないためです。