Set-CsNetworkRegion

구문

Set-CsNetworkRegion [-Identity <XdsGlobalRelativeIdentity>] [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-CentralSite <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkRegion [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-CentralSite <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

자세한 정보

네트워크 영역은 여러 지역의 많은 네트워크 부분을 교차합니다. 모든 네트워크 영역은 중앙 사이트와 연결되어 있어야 합니다. 중앙 사이트는 CAC(통화 허용 제어) 대역폭 정책 서비스가 실행되는 데이터 센터 사이트입니다. 이 cmdlet을 사용하면 오디오 및 비디오 연결에 대체 경로가 허용되는지 여부를 결정하는 설정, 지역 내의 사이트를 미디어 우회 구성과 연결하는 설정 등을 포함하여 기존 네트워크 지역을 수정할 수 있습니다.

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

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

매개 변수

입력 형식

Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType 개체입니다. 네트워크 영역 개체의 파이프라인된 입력을 허용합니다.

반환 형식

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

예제

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

Set-CsNetworkRegion -Identity NorthAmerica -Description "North American Region"

이 예제에서는 NorthAmerica라는 네트워크 지역을 수정합니다. Description 매개 변수에는 "North American Region" 값을 지정합니다. 이 명령은 NorthAmerica 지역에 Description이 있는 경우 이 값으로 해당 Description을 덮어쓰고, 설정된 Description이 없는 경우 Description을 설정합니다.

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

Set-CsNetworkRegion -Identity EMEA -VideoAlternatePath $False

이 예제에서는 EMEA라는 네트워크 지역을 수정하고 새 비디오 대체 경로 설정을 제공합니다. 이 작업을 수행하기 위해 Set-CsNetworkRegion을 호출하고 Identity(EMEA)를 전달합니다. 그런 다음 VideoAlternatePath 매개 변수를 지정하고 $False 값을 전달합니다. VideoAlternatePath를 False로 설정하면 적절한 대역폭을 사용할 수 없는 경우 화상 통화가 대체 경로로 경로 지정되지 않고 완료되지 않습니다.

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

$a = Get-CsNetworkRegion -Identity NorthAmerica
$a.BWAlternatePaths | foreach {Set-CsNetworkRegion -Identity Asia -BWAlternatePaths @{add=$_}}

예제 3에서는 NorthAmerica 지역에 설정된 것과 동일한 대체 경로 설정 집합을 Asia 네트워크 지역에 할당합니다. 이 예제의 첫째 줄은 NorthAmerica 네트워크 지역의 인스턴스를 검색하여 $a 변수에 할당합니다. 둘째 줄은 먼저 $a 변수에 저장된 BWAlternatePaths 속성 또는 NorthAmerica 지역의 콘텐츠($a.BWAlternatePaths)를 검색합니다. 그러면 NorthAmerica 지역의 모든 대체 경로 설정 컬렉션이 반환됩니다.

이 설정 컬렉션을 foreach 함수에 파이프합니다. Foreach는 한 번에 하나씩 컬렉션의 항목을 확인하여 그 뒤의 중괄호에 있는 작업을 수행합니다. 이 경우에는 Identity가 Asia인 Set-CsNetworkRegion을 호출하여 Asia 지역의 속성을 설정합니다. 다음 매개 변수는 BWAlternatePaths입니다. 이 매개 변수에 @{add=$_} 값을 전달합니다. $_ 변수는 컬렉션의 현재 항목(여기서는 현재 대체 경로)을 나타내고, 값의 @{add=} 부분은 이 항목을 Asia 지역의 BWAlternatePaths 컬렉션에 추가합니다.

참고 항목

기타 리소스

New-CsNetworkRegion
Remove-CsNetworkRegion
Get-CsNetworkRegion
New-CsNetworkBWAlternatePath