Set-CsCallParkOrbit
トピックの最終更新日: 2012-03-26
組織内の既存の通話保留オービット範囲のプロパティを設定します。
構文
Set-CsCallParkOrbit [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] [-CallParkService <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsCallParkOrbit [-NumberRangeStart <String>] [-NumberRangeEnd <String>] [-CallParkService <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
解説
通話を保留 (パーク) すると、着信通話は、後で再開できるよう特定の範囲の番号に割り当てられます。通話保留オービットは、この目的のために定義された番号のセットです。Set-CsCallParkOrbit コマンドレットでは、この番号の範囲と、通話保留サービスの ID を変更できます。新しい番号の範囲は、組織内で定義されたすべての通話保留オービット間で一意である必要があります。
このコマンドレットを実行できるユーザー: 既定では、Set-CsCallParkOrbit コマンドレットをローカルで実行する権限があるのは、RTCUniversalServerAdmins グループのメンバーです。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsCallParkOrbit"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
文字列 |
変更する通話保留オービット範囲の一意の識別子です。Identity にスペースがある場合は、この値を二重引用符で囲む必要があります。 |
Instance |
省略可能 |
DisplayCallParkOrbit |
個々のパラメーター値を設定するのではなく、オブジェクトへの参照をコマンドレットに渡せるようにします。このオブジェクトは DisplayCallParkOrbit 型である必要があり、Get-CsCallParkOrbit コマンドレットを呼び出すことで取得できます。 |
CallParkService |
必須 |
文字列 |
コール パーク アプリケーション をホストするアプリケーション サービスの完全修飾ドメイン名 (FQDN) またはサービス ID です。NumberRangeStart パラメーターと NumberRangeEnd パラメーターで指定された範囲の番号に保留されるすべての通話は、このサーバーまたはプールにルーティングされます。 |
NumberRangeStart |
必須 |
文字列 |
この通話保留オービットの範囲内の最初の番号です。値は最大で NumberRangeEnd までにする必要があります。また、NumberRangeEnd の値と同じ長さである必要があります。 有効な値は次のとおりです。正規表現文字列 ([\*|#]?[1-9]\d{0,7})|([1-9]\d{0,8}) に一致する必要があります。つまり、値は * または # の文字あるいは 1 ～ 9 の数字 (最初の文字を 0 にすることは不可) で始まる文字列にする必要があります。最初の文字が * または # である場合、次の文字は 1 ～ 9 の数字にします (0 は不可)。後に続く文字には、0 ～ 9 の任意の数字を最大 7 文字まで指定できます (たとえば、"#6000"、"*92000"、および "*95551212" など)。* または # に続く数字は 100 より大きいことが必要です。最初の文字が * または # ではない場合、最初の文字には 1 ～ 9 の数字 (0 は不可) を指定し、後の文字には 0 ～ 9 の任意の数字を最大 8 文字まで指定します (たとえば、915551212、41212、300 など)。 |
NumberRangeEnd |
必須 |
文字列 |
この通話保留オービットの範囲内の最後の番号です。値は NumberRangeStart 以上にする必要があります。また、NumberRangeStart の値と同じ長さである必要があります。たとえば、NumberRangeStart を 100 に設定した場合は、NumberRangeEnd を 1001 にすることはできません。さらに、NumberRangeStart が * または # で始まる場合は、NumberRangeEnd も同じ文字で始まる必要があります。 有効な値は次のとおりです。正規表現文字列 ([\*|#]?[1-9]\d{0,7})|([1-9]\d{0,8}) に一致する必要があります。つまり、値は * または # の文字あるいは 1 ～ 9 の数字 (最初の文字を 0 にすることは不可) で始まる文字列にする必要があります。最初の文字が * または # である場合、次の文字は 1 ～ 9 の数字にします (0 は不可)。後に続く文字には、0 ～ 9 の任意の数字を最大 7 文字まで指定できます (たとえば、"#6000"、"*92000"、および "*95551212" など)。最初の文字が * または # ではない場合、最初の文字には 1 ～ 9 の数字 (0 は不可) を指定し、後の文字には 0 ～ 9 の任意の数字を最大 8 文字まで指定します (たとえば、915551212、41212、300)。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.Voice.Helpers.DisplayCallParkOrbit オブジェクトです。通話保留オービット オブジェクトのパイプ処理による入力を受け入れます。
戻り値の種類
このコマンドレットは、Microsoft.Rtc.Management.Voice.Helpers.DisplayCallParkOrbit 型のオブジェクトを変更します。
例
-------------------------- 例 1 --------------------------
Set-CsCallParkOrbit -Identity "Redmond CPO 1" -NumberRangeStart 500 -NumberRangeEnd 699
この例では、"Redmond CPO 1" という通話保留オービットの番号の範囲を、500 ～ 699 に変更します。この範囲内の値はすべて、組織内のすべての通話保留オービット範囲において一意である必要があります。
-------------------------- 例 2 --------------------------
Set-CsCallParkOrbit -Identity "Redmond CPO 2" -NumberRangeStart "*7000" -NumberRangeEnd "*7100"
この例では、"Redmond CPO 2" という通話保留オービットの番号の範囲を、*7000 ～ *7100 に変更します。この範囲内の値はすべて、組織内のすべての通話保留オービット範囲において一意である必要があります。前の例とは異なり、NumberRangeStart と NumberRangeEnd に割り当てられた値が二重引用符で囲まれていることに留意してください。これらの値が * または # で始まる場合 (数字以外で許可されている値はこの 2 文字のみ) は、値を二重引用符で囲みます。