Remove-CsNetworkBandwidthPolicyProfile

Skype for Business Server 2015
 

Дата изменения раздела:2017-03-28

Удаляет профиль политик пропускной способности сети. Данный командлет впервые появился в Lync Server 2010.

Remove-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Этот пример удаляет профиль политик пропускной способности с идентификатором Identity LowBWProfile. Поскольку идентификаторы должны быть уникальными, данный пример удалит не более одного профиля.

Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

В примере 2 удаляются все ссылки на профиль политики пропускной способности с идентификатором LowBWProfile со всех сайтов, которым он был назначен, а затем удаляется сам этот профиль. Первая строка данного примера начинается с вызова командлета Get-CsNetworkSite , возвращающего все сайты, для которых настроен контроль допуска звонков (CAC). Затем эта коллекция сайтов передается в командлет Where-Object , который ищет только сайты со свойством BWPolicyProfileID, равным (-eq) LowBWProfile. Эта отфильтрованная коллекция передается в командлет Set-CSNetworkSite , который изменяет значение BWPolicyProfileID на Null ($null) для каждого из сайтов. Итак, мы только что нашли все сайты со свойством BWPolicyProfileID, равным LowBWProfile, и изменили его значение на Null. На этом этапе сайты, использующие профиль LowBWProfile, отсутствуют. Теперь мы вызываем командлет Remove-CsNetworkBandwidthPolicyProfile для профиля LowBWProfile, чтобы удалить его, так как знаем, что профиль не используется ни одним из сайтов.

Чтобы убедиться. что профиль не используется ни в одной из частей конфигурации сети, выполните те же самые действия из строки 1 для политик межсайтового взаимодействия и связей между областями сети.

Get-CsNetworkSite | Where-Object {$_.BWPolicyProfileID -eq "LowBWProfile"} | Set-CsNetworkSite -BWPolicyProfileID $null
Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

В рамках контроля допуска звонков политика пропускной способности используется, чтобы определять ограничения пропускной способности для конкретных модальностей. (В Skype для бизнеса Server 2015 ограничения пропускной способности можно назначить только модальностям звука и видео.) Данный командлет удаляет для этих политик профиль контейнера.

ВАЖНО. Если профиль был назначен сайту (с помощью командлета 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

Обязательный

Microsoft.Rtc.Management.Xds.XdsGlobalRelativeIdentity

Строковое значение, которое однозначно определяет профиль политик пропускной способности, который требуется удалить. Указание параметра Identity приведет к удалению не более одного профиля.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

Force

Необязательный

System.Management.Automation.SwitchParameter

Подавляет все запросы на подтверждение, которые в противном случае будут отображаться перед применением изменений.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Описывает, что произойдет при выполнении команды без реального выполнения команды.

Объект Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType. Принимает входные данные из конвейера в виде объектов профиля политик пропускной способности сети.

Этот командлет не возвращает значение. Он удаляет объект типа Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType.

 
Показ: