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