Get-CsNetworkInterSitePolicy
마지막으로 수정된 항목: 2012-03-23
CAC(통화 허용 제어) 구성 내에 직접 연결된 사이트 간 대역폭 제한을 정의하는 하나 이상의 네트워크 사이트 정책을 검색합니다.
구문
Get-CsNetworkInterSitePolicy [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkInterSitePolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
자세한 정보
네트워크 사이트에서 직접 연결을 공유하는 경우 이 두 사이트 간에 오디오 및 비디오 연결에 대한 대역폭 제한이 정의될 수 있습니다. 이 cmdlet은 직접 연결된 사이트에 대역폭 제한 정책을 적용하는 하나 이상의 네트워크 사이트 정책을 검색합니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalUserAdmins 및 RTCUniversalServerAdmins 그룹의 구성원은 Get-CsNetworkInterSitePolicy cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkInterSitePolicy"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds 글로벌 상대 ID |
검색할 네트워크 사이트 정책의 고유 식별자입니다. 네트워크 사이트 정책은 글로벌 범위에서만 만들어지므로 이 식별자는 범위를 지정할 필요가 없습니다. 대신 여기에는 해당 정책을 식별하는 고유한 이름인 문자열이 포함됩니다. |
Filter |
선택 |
문자열 |
ID 값이 와일드카드 문자열과 일치하는 정책을 검색하는 와일드카드 문자가 포함된 문자열입니다. |
LocalStore |
선택 |
스위치 매개 변수 |
중앙 관리 저장소 자체가 아니라 중앙 관리 저장소의 로컬 복제본에서 사이트 간 정책 정보를 검색합니다. |
입력 형식
없음.
반환 형식
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType 유형의 개체를 검색합니다.
예제
-------------------------- 예제 1 --------------------------
Get-CsNetworkInterSitePolicy
Get-CsNetworkInterSitePolicy를 매개 변수 없이 호출하면 직접 연결된 두 네트워크 사이트 간에 정의된 모든 네트워크 사이트 정책이 검색됩니다.
-------------------------- 예제 2 --------------------------
Get-CsNetworkInterSitePolicy -Identity Reno_Portland
이 예제에서는 ID가 Reno_Portland인 네트워크 사이트 정책을 검색합니다.
-------------------------- 예제 3 --------------------------
Get-CsNetworkInterSitePolicy -Filter *Reno*
예제 3에서는 Identity 값 내에 Reno 문자열이 있는 모든 네트워크 사이트 정책을 검색합니다. Filter 매개 변수에 전달된 값 내에 있는 와일드카드 문자(*)는 "모든 문자 또는 문자 집합"을 의미합니다. 즉, *Reno* 문자열은 임의의 문자로 시작하고 다음에 Reno 문자열이 오고 다음에 임의 문자가 오는 Identity 값과 일치합니다.
-------------------------- 예제 4 --------------------------
Get-CsNetworkInterSitePolicy | Where-Object {$_.BWPolicyProfileID -eq $null}
이 예제에서는 대역폭 정책 프로필이 할당되지 않은 모든 네트워크 사이트 정책을 검색합니다. 먼저 예제 1에서와 같이 모든 네트워크 사이트 정책 컬렉션을 검색하는 Get-CsNetworkInterSitePolicy를 호출합니다. 이 컬렉션은 Where-Object cmdlet에 파이프됩니다. Where-Object는 대역폭 정책 프로필이 할당되지 않은 사이트 정책만 포함하도록 컬렉션 범위를 좁힙니다. 이를 위해 각 사이트 정책의 BWPolicyProfileID 속성이 Null($null)과 같은지(-eq) 비교하여 확인합니다.