Remove-CsNetworkSite
トピックの最終更新日: 2012-03-26
通話受付管理 (CAC) または Enhanced 9-1-1 (E9-1-1) 用に定義されたネットワーク サイトを削除します。
構文
Remove-CsNetworkSite -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
ネットワーク サイトは、CAC または E9-1-1 展開の各地域内で構成されるオフィスまたは拠点です。このコマンドレットを実行すると、CAC または E9-1-1 構成からサイトが削除されます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Remove-CsNetworkSite コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkSite"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsGlobalRelativeIdentity |
削除するネットワーク サイトの一意の識別子。サイトはグローバル スコープでのみ作成されるため、スコープを指定する必要はありません。代わりに、サイト ID のみを指定する必要があります。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType オブジェクトです。ネットワーク サイト オブジェクトのパイプライン処理された入力を受け入れます。
戻り値の種類
このコマンドレットには戻り値はありません。このコマンドレットを実行すると、Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 型のオフジェクトが削除されます。
例
-------------------------- 例 1 --------------------------
Remove-CsNetworkSite -Identity Vancouver
この例では、CAC または E9-1-1 構成から Vancouver という Identity を持つサイトを削除します。
-------------------------- 例 2 --------------------------
Get-CsNetworkSite | Where-Object {$_.BWPolicyProfileID -eq "LowBWProfile"} | Remove-CsNetworkSite
例 2 では、CAC または E9-1-1 構成から LowBWProfile という名前の帯域幅ポリシー プロファイルを使用しているすべてのサイトを削除します。この例では、まず Get-CsNetworkSite を呼び出して、すべてのネットワーク サイトを取得します。このサイトのコレクションが Where-Object コマンドレットにパイプ処理され、BWPolicyProfileID が LowBWProfile と等しい (-eq) サイトのみに絞り込まれます。この新しいコレクションが Remove-CsNetworkSite にパイプ処理され、これらのサイトが削除されます。