Set-CsNetworkBandwidthPolicyProfile

구문

Set-CsNetworkBandwidthPolicyProfile [-Identity <XdsGlobalRelativeIdentity>] [-AudioBWLimit <String>] [-AudioBWSessionLimit <String>] [-BWPolicy <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-VideoBWLimit <String>] [-VideoBWSessionLimit <String>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkBandwidthPolicyProfile [-AudioBWLimit <String>] [-AudioBWSessionLimit <String>] [-BWPolicy <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VideoBWLimit <String>] [-VideoBWSessionLimit <String>] [-WhatIf [<SwitchParameter>]]

자세한 정보

CAC(통화 허용 제어)의 일부로 특정 형식의 대역폭 제한을 정의하기 위해 대역폭 정책이 사용됩니다. Microsoft Lync Server 2010에서는 오디오 및 비디오 형식에만 대역폭 제한을 할당할 수 있습니다. 이 cmdlet은 이러한 정책의 컨테이너 프로필을 수정합니다.

중요: 프로필에 여러 정책이 포함된 경우(예: 오디오 정책 하나와 비디오 정책 하나) AudioBWLimit, AudioBWSessionLimit, VideoBWLimit 또는 VideoBWSessionLimit 속성을 사용하여 프로필을 수정하면 프로필의 모든 기존 정책이 제거되고 새 값으로 대체됩니다. 프로필에 비디오를 제한하는 정책이 포함되어 있고 AudioBWLimit 매개 변수만 설정한 경우 비디오 정책이 제거되고 오디오 정책이 생성됩니다.

이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 Set-CsNetworkBandwidthPolicyProfile cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkBandwidthPolicyProfile"}

매개 변수

입력 형식

Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType 개체입니다. 네트워크 대역폭 정책 프로필 개체의 파이프라인된 입력을 허용합니다.

반환 형식

이 cmdlet은 값을 반환하지 않습니다. Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType 유형의 개체를 수정합니다.

예제

-------------------------- 예제 1 --------------------------

Set-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile -Description "Policy for links of less than 10MB"

이 예제는 ID가 LowBWProfile인 대역폭 정책 프로필의 설명을 수정합니다. 이 작업을 수행하기 위해 Set-CsNetworkBandwidthPolicyProfile을 수정할 프로필 이름을 지정하는 Identity 및 프로필에 대한 새 설명을 지정하는 Description의 두 매개 변수와 함께 호출합니다.

-------------------------- 예제 2 --------------------------

Set-CsNetworkBandwidthPolicyProfile -Identity LowBWLimit -VideoBWLimit 2500 -VideoBWSessionLimit 300

예제 2는 ID가 LowBWLimit인 대역폭 정책 프로필에 대한 비디오 전송의 전체 제한 및 세션 제한을 수정합니다. 수정할 프로필의 ID를 지정한 후 VideoBWLimit 매개 변수를 사용하여 전체 비디오 제한을 2500으로 설정합니다. 그런 다음 VideoBWSessionLimit 매개 변수를 사용하여 개별 세션 제한을 300으로 설정합니다. 이 명령은 비디오 프로필을 추가하거나 LowBWLimit 대역폭 정책 프로필의 기존 비디오 프로필을 업데이트합니다. 기존 오디오 프로필은 영향을 받지 않습니다.

-------------------------- 예제 3 --------------------------

$bp = New-CsNetworkBWPolicy -BWLimit 5000 -BWSessionLimit 200 -BWPolicyModality video
Set-CsNetworkBandwidthPolicyProfile -Identity LowBWLimit -BWPolicy $bp

이 예제에서는 새 대역폭 정책을 만들어 ID가 LowBWLimit인 대역폭 정책 프로필에 할당합니다. 이 예제의 첫째 줄은 New-CsNetworkBWPolicy cmdlet에 대한 호출입니다. 이 cmdlet은 새 프로필을 만듭니다. 이 경우에는 제한이 5000kbps(-BWLimit 5000)이고 세션 제한이 200kbps(-BWSessionLimit 200)인 비디오 프로필(-BWPolicyModality video)입니다. 이 새 프로필 개체는 $bp 변수에 저장됩니다. 이 예제의 다음 줄은 Set-CsNetworkBandwidthPolicyProfile을 호출하여 LowBWLimit 프로필을 수정합니다(-Identity LowBWLimit). BWPolicy 매개 변수에는 $bp 값을 사용합니다. 이는 이 프로필의 기존 정책을 $bp 변수에 저장된 새로 만든 정책으로 대체합니다.

-------------------------- 예제 4 --------------------------

$a = Get-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile
$ap = New-CsNetworkBWPolicy -BWLimit 2000 -BWSessionLimit 300 -BWPolicyModality audio
$a.BWPolicy.Add($ap)
Set-CsNetworkBandwidthPolicyProfile -Instance $a

예제 4는 LowBWProfile 프로필의 기존 정책 집합에 새 오디오 대역폭 정책을 추가합니다. 첫째 줄에서는 Get-CsNetworkBandwidthPolicyProfile을 호출하여 ID가 LowBWProfile인 프로필을 검색합니다. 해당 프로필을 $a 변수에 저장합니다. 다음 줄에서는 New-CsNetworkBWPolicy를 호출하여 새 대역폭 정책을 만듭니다. 이 정책은 제한이 2000kbps(-BWLimit 2000)이고 세션 제한이 300kbps(-BWSessionLimit 300)인 오디오 정책(-BWPolicyModality audio)입니다. 이 새 정책은 $ap 변수에 저장됩니다.

셋째 줄에서는 첫째 줄에서 검색한 프로필($a 변수에 저장됨)에 새 오디오 정책($ap에 저장됨)을 추가합니다. 이를 수행하기 위해 프로필에서 BWPolicy 속성의 Add 메서드를 호출하고 $ap 값을 전달합니다 이는 "$ap에 저장된 새 정책을 LowBWProfile 프로필의 BWPolicy($a에 저장됨)에 추가하는 것"으로 해석할 수 있습니다.

마지막으로 Set-CsNetworkBandwidthPolicyProfile을 호출하여 LowBWProfile 프로필을 업데이트합니다. Instance 매개 변수를 사용하고 수정된 프로필이 포함된 $a 값을 전달합니다.

-------------------------- 예제 5 ------------------------

$ap = New-CsNetworkBWPolicy -BWLimit 2000 -BWSessionLimit 300 -BWPolicyModality audio
Set-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile -BWPolicy @{add=$ap}

예제 5는 기능 면에서 예제 4와 동일합니다. LowBWProfile 프로필의 기존 정책 목록에 새 오디오 정책을 추가합니다. 이 메서드에 필요한 줄 수가 더 적지만 확실한 것은 아닙니다. 이 예제를 여기에 포함한 이유는 동일한 작업을 여러 가지 방법으로 수행할 수 있음을 보여 주기 위함입니다.

첫째 줄에서는 새 오디오 대역폭 정책을 만들고 대역폭 제한(2000) 및 세션 제한(300)을 설정하고 새 개체를 $ap 변수에 저장합니다. 다음으로, Set-CsNetworkBandwidthPolicyProfile을 호출하여 ID가 LowBWProfile인 프로필을 수정합니다. BWPolicy 매개 변수를 사용하여 프로필 내 정책 목록을 수정합니다. 이 매개 변수에 전달한 @{add=$ap} 값을 보십시오. 이는 Windows PowerShell에서 목록에 무언가를 추가할 수 있는 방법입니다. 맨 앞에 @ 기호를 입력한 다음 중괄호({})를 입력합니다. 이 중괄호 안에 목록에 대해 수행할 작업을 지정합니다. 이 경우에는 목록에 추가하는 작업입니다. 제거 또는 대체 작업을 수행할 수도 있습니다. add 작업 뒤에 등호를 입력한 후 목록에 추가할 개체를 입력합니다. 이 경우에는 $ap 변수에 저장한 새 정책입니다.

참고 항목

기타 리소스

New-CsNetworkBandwidthPolicyProfile
Remove-CsNetworkBandwidthPolicyProfile
Get-CsNetworkBandwidthPolicyProfile
New-CsNetworkBWPolicy