Get-CsSipDomain
トピックの最終更新日: 2012-03-23
組織での使用向けに構成されている SIP ドメインに関する情報を戻します。SIP ドメインは、SIP トラフィックの送受信を承認されたドメインのことで、SIP アドレスをユーザーに割り当てるときに使用されます。
構文
Get-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSipDomain [-Filter <String>]
解説
ユーザーの SIP アドレスを構成するには (またこのために、ユーザーが Microsoft Lync 2010 などの SIP 関連ソフトウェアを使用できるようにするには)、次の 2 つの情報が必要です。ユーザー ID (Ken Myer など) と SIP ドメイン (litwareinc.com など) です。SIP アドレスを構成するのに使用する SIP ドメインは、SIP トラフィックの送受信が承認されている Active Directory フォレスト内にあるドメインである必要があります。たとえば、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 コマンドレットを実行してこれを行うことができます。
Get-CsSipDomain コマンドレットは、組織での使用が承認されている SIP ドメインに関する情報を戻す方法を提供します。Get-CsSipDomain は、組織での既定の SIP ドメインを識別する役割も果たします。これは、SIP ドメインが指定されていない場合に Microsoft Lync Server 2010 が既定で使用するドメインです。
このコマンドレットを実行できるユーザー: 既定では、Get-CsSipDomain コマンドレットをローカルで実行する権限があるのは、RTCUniversalServerAdmins グループのメンバーです。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSipDomain"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
文字列 |
戻される SIP ドメインの完全修飾ドメイン名 (FQDN) です (たとえば、fabrikam.com)。このパラメーターと Filter パラメーターのどちらも指定しない場合は、組織内での使用が承認されているすべての SIP ドメインが戻されます。 |
Filter |
省略可能 |
文字列 |
戻そうとする SIP ドメインの Identity を指定するときに、ワイルドカードを使用できるようにします。たとえば、フィルターの値として "*.org" を指定すると、".org" という文字列の値で終わる Identity を持つ、承認されたすべての SIP ドメインのコレクションが戻されます。 |
入力の種類
なし。Get-CsSipDomain は、パイプ処理データを受け入れません。
戻り値の種類
Get-CsSipDomain を実行すると、Microsoft.Rtc.Management.Xds.SipDomain オブジェクトのインスタンスが戻されます。
例
-------------------------- 例 1 ------------------------
Get-CsSipDomain
例 1 では、パラメーターなしで Get-CsSipDomain を呼び出します。この結果、組織での使用向けに構成されているすべての SIP ドメインに関する情報が戻されます。
-------------------------- 例 2 ------------------------
Get-CsSipDomain -Identity fabrikam.com
例 2 で示すコマンドは、fabrikam.com という Identity を持つすべての SIP ドメインに関する情報を戻します。SIP ドメインの Identity は一意であることが必要なので、このコマンドを実行して複数の項目が戻されることはありません。
-------------------------- 例 3 ------------------------
Get-CsSipDomain -Filter "f*"
上記のコマンドは、Get-CsSipDomain と Filter パラメーターを使用して、文字 "f" で始まる Identity を持つすべての SIP ドメインに関する情報を戻します。次に例を示します。fabrikam.com、fabrikam.org、fabrikam-users.com などです。
-------------------------- 例 4 ------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -eq $True}
例 4 に示したコマンドを実行すると、既定の SIP ドメインに関する情報が戻されます。これを実行するには、最初にパラメーターなしで Get-CsSipDomain を呼び出します。この結果、組織での使用向けに構成されているすべての SIP ドメインのコレクションが戻されます。次に、このコレクションを Where-Object コマンドレットにパイプ処理し、IsDefault プロパティが True に等しい 1 つのドメインを選択します。