次の方法で共有


Get-CsCpsConfiguration

 

トピックの最終更新日: 2012-03-23

コール パーク サービスに関する情報を返します。通話のパークは、ユーザーが着信通話を保留 (パーク) できるサービスです。通話をパークすると、指定された範囲 (オービット) の番号に通話を転送し、次にその通話を直ちに保留にします。正しい番号を入力するだけで、誰でも (最初の電話に出た人以外も)、システム内にあるどの電話からでも通話を再開できます。

構文

Get-CsCpsConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsCpsConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

解説

1 つ以上のコール パーク サービス構成を取得する場合に、このコマンドレットを使用します。コール パーク サービス構成は、パークされた通話の処理方法を指定します。たとえば、パークされた通話がしばらくの間応答されない場合は、管理者または応答グループなど、別の人に自動的に転送されます。通話は、応答忘れを防ぐために、一定の時間が経過した後にかけ直すように構成することもできます。また、通話がパークされている間、発信者に対して保留音が再生されるようにコール パーク サービスを構成することもできます。

このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーが Get-CsCpsConfiguration コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsCpsConfiguration"}

パラメーター

パラメーター 必須かどうか 説明

Identity

省略可能

XdsIdentity

取得するコール パーク サービス構成の一意の識別子です。この識別子は Global または site:<sitename> のいずれかになります。ここで、<sitename> は、構成が適用されるサイトの名前です。

Filter

省略可能

文字列

ワイルドカード文字列に一致する ID 値を持つ構成のみを取得できるように、ワイルドカード検索を実行できます。

LocalStore

省略可能

SwitchParameter

中央管理ストア 自体からではなく、中央管理ストア のローカル レプリカからコール パーク サービス情報を取得します。

入力の種類

なし。

戻り値の種類

Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings 型の 1 つ以上のオブジェクトを取得します。

-------------------------- 例 1 --------------------------

Get-CsCpsConfiguration

例 1 では、組織で使用するように定義されたすべてのコール パーク サービス構成のコレクションを取得します。

-------------------------- 例 2 --------------------------

Get-CsCpsConfiguration -Identity site:Redmond1

上記のコマンドは、site:Redmond1 の Identity を持つコール パーク サービス構成を取得します。

-------------------------- 例 3 --------------------------

Get-CsCpsConfiguration -Filter site:*

例 3 では、Filter パラメーターを使用して、サイト スコープで構成されたすべてのコール パーク サービス構成を戻します。ワイルドカード文字列 site:* は、ID が site: の文字列値で始まる設定のみを戻すように、Get-CsCpsConfiguration に指示します。

-------------------------- 例 4 --------------------------

Get-CsCpsConfiguration -Filter *:re*

例 3 では、Filter パラメーターを使用して、定義済みのすべてのコール パーク サービス構成のサブセットを取得します。この場合、文字列 *:re* でフィルター処理を行います。これにより、Redmond1、Redmond2、および RemoteComputer など、re という文字で始まる名前を持つすべてのサイトのコール パーク構成が戻されます。

-------------------------- 例 5 --------------------------

Get-CsCpsConfiguration | Where-Object {$_.EnableMusicOnHold -eq $False}

上のコマンドは、発信者が保留中のときに保留音を再生しないすべてのコール パーク サービス設定を戻します。この処理を実行するには、まず、Get-CsCpsConfiguration を使用して、組織で使用するように構成されたすべてのコール パーク サービス設定を取得します。次に、このコレクションは Where-Object コマンドレットにパイプ処理されます。これにより、返りデータを制限するフィルターが EnableMusicOnHold プロパティが False に等しい (-eq) 項目に適用されます。