Set-CsCpsConfiguration
トピックの最終更新日: 2012-03-26
既存の通話保留サービス設定のコレクションを変更します。通話保留は、ユーザーが着信通話を保留 (パーク) できるようにするサービスです。通話をパークすると、指定された範囲 (オービット) の番号に通話を転送し、次にその通話を直ちに保留にします。正しい番号を入力するだけで、だれでも (最初に電話に出た人以外も)、どの電話からでも通話を再開できます。
構文
Set-CsCpsConfiguration [-Identity <XdsIdentity>] [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]
Set-CsCpsConfiguration [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]
解説
このコマンドレットは、既存の通話保留サービス構成を変更する場合に使用します。通話保留サービス構成は、パークされた通話の処理方法を指定します。たとえば、パークされた通話がしばらくの間応答されない場合は、管理者や応答グループなど、別の人に自動的に転送されます。通話は、応答忘れを防ぐために、一定の時間が経過した後にかけ直すように構成することができます。また、通話がパークされている間、発信者に対して保留音が再生されるように通話保留サービスを構成することもできます。
このコマンドレットを実行できるユーザー: 既定では、Set-CsCpsConfiguration コマンドレットをローカルで実行する権限があるのは、RTCUniversalServerAdmins グループのメンバーです。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsCpsConfiguration"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
省略可能 |
文字列 |
変更する構成の一意の識別子です。ID により、構成の適用範囲を指定します。グローバルまたは特定のサイト (site:<sitename> の形式。site:Redmond など) のいずれかを指定します。 |
Instance |
省略可能 |
CallParkServiceSettings |
Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings 型の通話保留サービス構成オブジェクトへのオブジェクト参照です。このオブジェクトは、Get-CsCpsConfiguration コマンドレットを呼び出すことで取得できます。その後、オブジェクトを変更してから、このパラメーターの Set-CsCpsConfiguration に渡すと、変更を保存できます。 |
CallPickupTimeoutThreshold |
省略可能 |
TimeSpan |
通話がパークされてから、呼び出しに応答した電話にかけ直されるまでの経過時間です。 hh:mm:ss (hh = 時間、mm = 分、ss = 秒) の形式で入力する必要があります。 最小値: 10 秒 (00:00:10)、最大値: 10 分 (00:10:00) |
EnableMusicOnHold |
省略可能 |
ブール値 |
通話がパークされている間、発信者に対してメロディを再生するかどうかを決定します。 Microsoft Lync Server 2010 には、既定の保留音ファイルが付属しています。Set-CsCallParkServiceMusicOnHoldFile コマンドレットを使用すると、このファイルを変更できます (その結果、パークされている間に発信者に対して再生されるメロディも変更されます)。 |
MaxCallPickupAttempts |
省略可能 |
Int32 |
パークされた通話が、かけ直しをやめて、代替 Uniform Resource Identifier (URI) に転送されるまでに、応答した電話にかけ直す回数です。代替 URI は、OnTimeoutURI パラメーターで設定します。 最小値: 1、最大値: 10。 |
OnTimeoutURI |
省略可能 |
文字列 |
パークされた通話が応答されなかった場合のルーティング先のユーザーまたは応答グループの SIP アドレスです。MaxCallPickupAttempts パラメーターで定義された回数のリングバックが実行された後で、パークされた通話はルーティングされます。このパラメーターが Null に設定されている場合、OnTimeoutURI は無視され、パークされた通話はリングバックの試行に失敗した後で切断されます。 値は、文字列 sip: で始まる SIP URI にする必要があります。たとえば、sip:rgs1@litwareinc.com のようにします。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings オブジェクトです。通話保留サービス構成オブジェクトのパイプ処理による入力を受け入れます。
戻り値の種類
Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings 型のオブジェクトを変更します。
例
-------------------------- 例 1 --------------------------
Set-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2
例 1 に示すコマンドは、Identity が site:Redmond1 の通話保留サービス構成を変更し、パークされた通話による応答電話へのかけ直し回数の上限を 2 に設定します。これを行うため、MaxCallPickupAttempts パラメーターを指定し、パラメーター値を 2 に指定しています。
-------------------------- 例 2 --------------------------
Get-CsCpsConfiguration | Set-CsCpsConfiguration -MaxCallPickupAttempts 2
例 2 は、例 1 で示したコマンドの変化形です。ただし、この例では、(1 つだけではなく) すべての通話保留サービス構成の MaxCallPickupAttempts プロパティの値が 2 になるように設定します。これを行うため、Get-CsCpsConfiguration を使用して、組織内で使用されているすべての通話保留サービス設定のコレクションを取得します。次に、このコレクションは Set-CsCpsConfiguration コマンドレットにパイプ処理され、これにより、コレクションの個々の項目が取り込まれ、MaxCallPickupAttempts プロパティの値が 2 に設定されます。
-------------------------- 例 3 --------------------------
Set-CsCpsConfiguration -Identity site:Redmond1 -CallPickupTimeoutThreshold 00:00:45
この例では、サイト Redmond1 の通話保留構成を変更し、パークされた通話によるかけ直しまでの経過時間 (CallPickupTimeoutThreshold プロパティに格納されています) を 45 秒に設定します。