Get-CsTrunkConfiguration
トピックの最終更新日: 2012-03-23
1 つ以上のトランク構成を取得します。これは、公衆交換電話網 (PSTN) ゲートウェイ、IP-PBX、サービス プロバイダーのセッション境界コントローラー (SBC) などのトランキング ピア エンティティの設定を説明するものです。
構文
Get-CsTrunkConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsTrunkConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
このコマンドレットを使用して、PSTN ゲートウェイ エンティティに適用可能な 1 つ以上のトランク構成を取得します。それぞれの構成には、PSTN ゲートウェイ、IP-PBX、サービス プロバイダーの SBC などの、トランキング ピア エンティティの固有の設定が含まれます。これらの設定では、このトランクでメディア バイパスが有効かどうか、特定の条件下でリアルタイム転送制御プロトコル (RTCP) パケットを送信するかどうか、セキュア リアルタイム プロトコル (SRTP) 暗号化を要求するかどうかなどを構成します。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Get-CsTrunkConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsTrunkConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsIdentity |
取得するトランク構成の一意の識別子。トランク構成はグローバル スコープまたはサイト スコープでも、PSTN ゲートウェイ サービスのサービス スコープでも定義できます。たとえば、site:Redmond (サイト用) または PstnGateway:Redmond.litwareinc.com (サービス用) です。 |
Filter |
省略可能 |
文字列 |
このパラメーターはワイルドカード文字列を受け入れ、その文字列と一致する ID を持つすべてのトランク構成を戻します。たとえば site:* というフィルター値を指定すると、サイト レベルで定義されているすべてのトランク構成が戻されます。 |
LocalStore |
省略可能 |
SwitchParameter |
中央管理ストア 自体ではなく、中央管理ストア のローカル レプリカからトランク構成を取得します。 |
入力の種類
なし。
戻り値の種類
このコマンドレットを実行すると、Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 型のオブジェクトが戻されます。
例
-------------------------- 例 1 ------------------------
Get-CsTrunkConfiguration
この例では、Microsoft Lync Server 2010 展開のすべてのトランク構成を取得します。
-------------------------- 例 2 ------------------------
Get-CsTrunkConfiguration -Identity site:Redmond
この例では、site:Redmond という ID を持つトランク構成を取得します。ID は一意であるため、このコマンドで戻されるオブジェクトは最大で 1 つです。
-------------------------- 例 3 ------------------------
Get-CsTrunkConfiguration -Filter site:*
例 3 では、サイト レベルで定義されているすべてのトランク構成を取得します。Get-CsTrunkConfiguration コマンドレットで Filter パラメーターを使用して、site: で始まる Identity を持つすべてのトランク構成 (つまり、サイト レベルで定義されているすべてのトランク構成) を取得します。