Remove-CsUnassignedNumber
トピックの最終更新日: 2012-03-26
割り当てられていない番号の既存の範囲およびこれらの番号に適用されているルーティング ルールを削除します。
構文
Remove-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
割り当てられていない番号とは、組織に割り当てられている一方で、特定のユーザーや電話には割り当てられていない電話番号です。割り当てられていない番号が呼び出されたとき、適切な通話先に通話をルーティングするよう Microsoft Lync Server 2010 を設定できます。このコマンドレットを実行すると、そのルーティングを定義している設定が削除されます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Remove-CsUnassignedNumber コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsUnassignedNumber"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsGlobalRelativeIdentity |
削除する割り当てられていない番号の範囲の一意の名前。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange オブジェクト。割り当てられていない番号オブジェクトのパイプライン処理された入力を受け入れます。
戻り値の種類
このコマンドレットには戻り値はありません。Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange 型のオブジェクトが削除されます。
例
-------------------------- 例 1 --------------------------
Remove-CsUnassignedNumber -Identity UNSet1
この例では、UNSet1 という ID を持つ割り当てられていない番号の設定を削除しています。
-------------------------- 例 2 --------------------------
Get-CsUnassignedNumber | Where-Object {$_.AnnouncementName -match "Welcome"} | Remove-CsUnassignedNumber
例 2 では、割り当てられていないアナウンスの名前に Welcome という文字列が含まれる、割り当てられていない番号のすべての設定を削除しています。コマンドでまず、Get-CsUnassignedNumber を呼び出し、割り当てられていない番号のすべての設定のコレクションを戻します。このコレクションを Where-Object コマンドレットに渡し、Welcome という文字列を含む (-match) AnnouncementName を持つ割り当てられていない番号の設定のみにコレクションを絞り込みます。最後に、絞り込んだコレクションを Remove-CsUnassignedNumber に渡し、コレクション内に残っているすべての項目を削除します。