Remove-CsLisSwitch
トピックの最終更新日: 2012-03-27
場所情報サーバー (LIS) のネットワーク スイッチを削除します。
構文
Remove-CsLisSwitch -ChassisID <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
解説
Enhanced 9-1-1 (E9-1-1) は、発信者に情報の問い合わせをしなくても、緊急通話事業者が発信者の位置を特定できるようにします。発信者がボイス オーバー IP (VoIP) 接続から発信している場合は、接続に関するさまざまな要素に基づいて、情報を抽出する必要があります。VoIP 管理者は、発信者の場所を決定する、場所のマップ (ワイヤマップと呼ばれます) を構成する必要があります。このコマンドレットを実行すると、場所構成データベースからスイッチが削除されます。スイッチを削除しても、実際の場所は削除されません。スイッチだけが削除されます。場所を削除するには、Remove-CsLisLocation コマンドレットを呼び出します。
スイッチの ChassisID がポートによって使用されている場合は、スイッチを削除できません (次のコマンドを実行して、ポートによって使用されている ChassisID を探します。Get-CsLisPort | Select-Object ChassisID)。スイッチを削除するには、まず、検出された ChassisID を使用しているすべてのポートを削除する必要があります。
存在しないスイッチを削除しようとすると、アクションは何も実行されず、エラー メッセージや警告メッセージを受け取ることはありません。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Remove-CsLisSwitch コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsLisSwitch"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
ChassisID |
必須 |
文字列 |
ネットワーク スイッチのメディア アクセス制御 (MAC) アドレスです。この値は、nn-nn-nn-nn-nn-nn の形式 (たとえば、12-34-56-78-90-ab) になります。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
パイプライン処理された LIS スイッチ オブジェクトの入力を受け入れます。
戻り値の種類
このコマンドレットには戻り値はありません。System.Management.Automation.PSCustomObject 型のオブジェクトを削除します。
例
-------------------------- 例 1 --------------------------
Remove-CsLisSwitch -ChassisID 99-99-99-99-99-99
例 1 では、MAC アドレス (ChassisID) が 99-99-99-99-99-99 である LIS スイッチを削除しています。
この ChassisID がポートによって参照されている場合、このコマンドは成功しません。また、このスイッチが場所と関連付けられていた場合、その場所は削除されません。場所のマッピングからスイッチのみが削除されます。
-------------------------- 例 2 --------------------------
Get-CsLisSwitch | Where-Object {$_.City -eq ""} | Remove-CsLisSwitch
この例では、市が指定されていないすべてのスイッチを削除します。この例では、最初に Get-CsLisSwitch コマンドレットを呼び出して、すべてのスイッチのコレクションを戻しています。このコレクションは Where-Object コマンドレットにパイプ処理され、コレクション内で City プロパティが空の (つまり、City の値が空の文字列 ("") と等しい (-eq)) 項目が探索されます。最後に、市の値が空になっているスイッチのコレクションを Remove-CsLisSwitch にパイプ処理して、そのコレクション内のすべてを削除します。
例 1 と同様、場所データベースから場所が削除されるのではなく、それらの場所を参照するスイッチのみが削除されます。この場合は、場所のデータベース内に無効な場所があり (無効となるのは、場所では City は必須のプロパティであるためです)、そのような場所も削除する必要があることを意味します。場所は、Remove-CsLisLocation コマンドレットを呼び出すことによって削除できます。