Remove-CsNetworkBandwidthPolicyProfile
トピックの最終更新日: 2012-03-26
ネットワーク帯域幅のポリシー プロファイルを削除します。
構文
Remove-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
帯域幅ポリシーは、通話受付管理 (CAC) の一部として、特定のモダリティの帯域幅制限を定義する際に使用します (Microsoft Lync Server 2010 では、オーディオとビデオのモダリティのみに帯域幅の制限を割り当てることができます。)このコマンドレットは、これらのポリシーのコンテナー プロファイルを削除します。
重要: プロファイルが、サイトに割り当てられている場合 (New-CsNetworkSite または Set-CsNetworkSite コマンドレットを使用)、サイト間ポリシーに割り当てられている場合 (New-CsNetworkInterSitePolicy または Set-CsNetworkInterSitePolicy コマンドレットを使用)、またはネットワーク地域リンクに割り当てられている場合 (New-CsNetworkRegionLink または Set-CsNetworkRegionLink コマンドレットを使用)、プロファイルを削除することはできません。Remove-CsNetworkBandwidthPolicyProfile を呼び出してプロファイルを削除しようとすると、エラーが送信されます。プロファイルを削除するには、まず、すべてのサイト、サイト間ポリシー、およびネットワーク地域リンクからプロファイルを削除する必要があります。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Remove-CsNetworkBandwidthPolicyProfile コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkBandwidthPolicyProfile"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsGlobalRelativeIdentity |
削除する帯域幅ポリシー プロファイルを一意に定義する文字列値。Identity を指定すると、最大 1 つのプロファイルのみが削除されます。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType オブジェクト。パイプライン処理されたネットワーク帯域ポリシー プロファイル オブジェクトの入力を受け入れます。
戻り値の種類
このコマンドレットには戻り値はありません。Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType 型のオブジェクトを削除します。
例
-------------------------- 例 1 --------------------------
Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile
この例では、Identity が LowBWProfile の帯域幅ポリシー プロファイルを削除します。Identity は一意である必要があるため、最大で 1 つのプロファイルのみが削除されます。
-------------------------- 例 2 --------------------------
Get-CsNetworkSite | Where-Object {$_.BWPolicyProfileID -eq "LowBWProfile"} | Set-CsNetworkSite -BWPolicyProfileID $null
Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile
例 2 では、Identity が LowBWProfile である帯域幅ポリシー プロファイルへのすべての参照を、割り当て先であるすべてのサイトから削除し、その後、そのプロファイルを削除します。この例の最初の行ではまず、Get-CsNetworkSite を呼び出して、通話受付管理 (CAC) が構成されたすべてのサイトを取得します。次に、サイトのこのコレクションは Where-Object にパイプ処理され、それにより、BWPolicyProfileID が LowBWProfile に等しい (-eq) サイトのみが検索されます。この絞り込まれたコレクションには、BWPolicyProfileID 値が LowBWProfile であるサイトのみが含まれ、Set-CSNetworkSite にパイプ処理されます。この処理により、これらの各サイトの BWPolicyProfileID が Null ($null) に変更されます。ここまでの処理で、BWPolicyProfileID が LowBWProfile であるすべてのサイトを検出して、その値を Null に設定しました。この時点で、LowBWProfile プロファイルを使用するサイトは存在しなくなります。プロファイル LowBWProfile がいずれのサイトでも使用されていないことがわかっているので、このプロファイルに対して Remove-CsNetworkBandwidthPolicyProfile を呼び出して、削除することができます。
ネットワーク構成のどの部分においてもプロファイルが使用されていないことを確認するには、サイト間ポリシーとネットワーク地域リンクに対して、1 行目と同じステップを実行します。