次の方法で共有


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 コマンドレットを呼び出すことによって削除できます。

関連項目

その他のリソース

Set-CsLisSwitch
Get-CsLisSwitch
Remove-CsLisLocation
Get-CsLisPort