Set-CsNetworkSite
마지막으로 수정된 항목: 2012-03-26
CAC(통화 허용 제어) 또는 E9-1-1(Enhanced 9-1-1)에 대해 정의된 기존 네트워크 사이트를 수정합니다.
구문
Set-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-LocationPolicy <String>] [-NetworkRegionID <String>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkSite [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationPolicy <String>] [-NetworkRegionID <String>] [-WhatIf [<SwitchParameter>]]
자세한 정보
네트워크 사이트는 각 CAC 또는 E9-1-1 배포 영역 내에 구성된 사무실 또는 위치입니다. 이 cmdlet은 기존 사이트의 설정을 수정합니다. 여기에는 사이트가 연결된 지역, 사이트에 대한 설명, 그리고 연결된 대역폭 정책 프로필과 같은 사항이 포함될 수 있습니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 Set-CsNetworkSite cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkSite"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds 글로벌 상대 ID |
수정할 네트워크 사이트의 고유한 식별자입니다. 사이트는 글로벌 범위에서만 만들어지므로 범위는 지정할 필요가 없습니다. 네트워크 사이트 ID만 지정하면 됩니다. |
Instance |
선택 |
네트워크 사이트 표시 유형 |
네트워크 사이트 개체(Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 유형의 개체)에 대한 참조입니다. 이 개체는 Get-CsNetworkSite cmdlet을 호출하여 검색할 수 있습니다. |
BWPolicyProfileID |
선택 |
문자열 |
이 사이트의 제한을 정의하는 대역폭 정책 프로필의 ID입니다. Get-CsNetworkBandwidthPolicyProfile cmdlet을 호출하여 사용 가능한 프로필 목록을 검색할 수 있습니다. 이 매개 변수의 값을 지정하면 NetworkRegionID 매개 변수의 값도 지정해야 합니다. |
BypassID |
선택 |
문자열 |
GUID(Globally Unique Identifier)입니다. 이 GUID는 네트워크 사이트를 CAC 또는 E9-1-1 네트워크 구성 내의 미디어 바이패스 설정으로 매핑하는 데 사용됩니다. New-CsNetworkMediaBypassConfiguration을 호출할 때 이 BypassID 값을 사용합니다. 이 매개 변수의 값을 지정하면 NetworkRegionID 매개 변수의 값도 지정해야 합니다. 이 매개 변수에 값을 지정하지 않고 NetworkRegionID를 지정하면 BypassID가 자동으로 생성됩니다. 명시적으로 값을 지정하는 경우 값 형식은 GUID 형식(예: 3b24a047-dce6-48b2-9f20-9fbff17ed62a)이어야 합니다. NetworkRegionID에 값을 지정하고 BypassID 값이 자동으로 생성되도록 하는 것이 좋습니다. 값을 수동으로 입력하면 값을 자동으로 생성하지 않을지를 확인하는 메시지가 표시됩니다. |
Description |
선택 |
문자열 |
사이트를 설명하는 문자열입니다. 이 매개 변수를 사용하면 사이트가 어떤 용도로 사용되고 어디에 있는지에 대해 ID만 사용할 때보다 더 자세한 설명을 제공할 수 있습니다. |
LocationPolicy |
선택 |
문자열 |
이 사이트와 연결된 위치 정책의 이름입니다. 위치 정책은 특정 E9-1-1 설정을 사이트에 할당합니다. 위치 정책의 목록을 검색하려면 Get-CsLocationPolicy cmdlet을 호출합니다. |
NetworkRegionID |
선택 |
문자열 |
이 사이트가 연결되어 있는 네트워크 지역의 ID입니다. BypassID(자동으로 생성하거나 수동으로 지정)를 제공하려고 하거나 네트워크 구성의 EnableBandwidthPolicyCheck 속성이 True인 경우 이 매개 변수에는 값이 포함되어야 합니다. Get-CsNetworkConfiguration cmdlet을 호출하여 네트워크 구성 설정을 검색할 수 있습니다. 이 사이트에 BypassID가 이미 존재하거나 BypassID 매개 변수에 대한 값을 지정하지 않으면 자동 생성된 BypassID가 기존 BypassID를 덮어씁니다. |
Force |
선택 |
스위치 매개 변수 |
변경하기 전에 표시되는 확인 메시지를 표시하지 않습니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 개체입니다. 네트워크 사이트 개체의 파이프라인된 입력을 허용합니다.
반환 형식
이 cmdlet은 값을 반환하지 않습니다. Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 유형의 개체를 수정합니다.
예제
-------------------------- 예제 1 --------------------------
Set-CsNetworkSite -Identity Vancouver -NetworkRegionID Canada
이 예제에서는 Vancouver라는 네트워크 사이트를 수정합니다. 수정할 사이트의 이름은 Identity 매개 변수의 값으로 지정합니다. Vancouver 사이트가 새 지역으로 이동되어 NetworkRegionID 매개 변수를 변경해야 하며 여기에서는 지역 이름 Canada로 지정했습니다. NetworkRegionID를 제공했지만 BypassID에는 값을 지정하지 않았으므로 BypassID 값이 자동으로 생성됩니다. 기존 바이패스 ID가 있을 경우 덮어씁니다.
-------------------------- 예제 2 --------------------------
Set-CsNetworkSite -Identity Vancouver - BWPolicyProfileID LowBWLimits
예제 2에서는 Vancouver 사이트와 연결된 대역폭 정책 프로필을 수정합니다. 사이트 이름은 Identity 매개 변수의 값으로 지정합니다. 그리고 BWPolicyProfileID 매개 변수의 값을 LowBWLimits로 지정합니다. 이 프로필과 연결된 정책이 이 사이트에 사용됩니다.