Remove-CsOutboundTranslationRule
トピックの最終更新日: 2012-03-25
既存の発信変換ルールを削除します。発信変換ルールは、電話番号を地域のダイヤル形式に変換して、構内交換機 (PBX) システムとやり取りできるようにします。
構文
Remove-CsOutboundTranslationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
既存の発信変換ルールを削除する場合は、このコマンドレットを呼び出します。Microsoft Lync Server 2010 は電話番号を E.164 形式に正規化します。ただし、多くの構内交換機 (PBX) システムはこの形式を扱うことができません。発信変換ルールは、番号を仲介サーバーまたはゲートウェイに送信する前に、番号を地域のダイヤル形式に変換します。
各発信変換ルールはトランク構成に関連付けられています。つまり、このコマンドレットを使用してルールを削除すると、該当のスコープでのトランク構成から削除されることになります。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Remove-CsOutboundTranslationRule コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsOutboundTranslationRule"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsIdentity |
削除する発信変換ルールの一意の識別子。Identity は、スコープの後に各スコープ内の一意の名前が続きます。たとえば、"site:Redmond/OutboundRule1" のようになります。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule オブジェクト。パイプライン処理された発信変換ルール オブジェクトの入力を受け入れます。
戻り値の種類
このコマンドレットには戻り値はありません。Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule 型のオブジェクトを削除します。
例
-------------------------- 例 1 --------------------------
Remove-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond"
この例では、"Prefix Redmond" というサイト Redmond の既存の発信変換ルールを削除します。Identity は一意なので、このコマンドで削除するのは 1 つのルールだけです。
-------------------------- 例 2 --------------------------
Get-CsOutboundTranslationRule -Filter site:* | Remove-CsOutboundTranslationRule
この例では、サイトレベルの発信変換ルールをすべて削除します。コマンドの最初の部分では、Filter を "site:*" に指定した状態で Get-CsOutboundTranslationRule を呼び出して、Identity 値が "site:" で始まるすべてのルールのコレクションを戻します。このコレクションは Remove-CsOutboundTranslationRule にパイプ処理され、それにより、コレクション内の各ルールが削除されます。