Get-CsNetworkSite
마지막으로 수정된 항목: 2012-03-23
CAC(통화 허용 제어) 또는 E9-1-1(Enhanced 9-1-1)에 대해 정의된 하나 이상의 네트워크 사이트를 검색합니다.
구문
Get-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSite [-Filter <String>] [-LocalStore <SwitchParameter>]
자세한 정보
네트워크 사이트는 각 CAC 또는 E9-1-1 배포 영역 내에 구성된 사무실 또는 위치입니다. 이 cmdlet은 하나 이상의 기존 사이트에 대한 설정을 검색합니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalUserAdmins 및 RTCUniversalServerAdmins 그룹의 구성원은 Get-CsNetworkSite cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkSite"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds 글로벌 상대 ID |
검색할 네트워크 사이트의 고유 식별자입니다. 사이트는 글로벌 범위에서만 만들어지므로 범위는 지정할 필요가 없습니다. 대신 사이트 ID만 지정하면 됩니다(네트워크 사이트에 대한 NetworkSiteID와 같은 값임). |
Filter |
선택 |
문자열 |
사이트 Identity와 Filter 값의 대조를 기반으로 여러 사이트를 검색할 수 있도록 하는 와일드카드 문자열입니다. |
LocalStore |
선택 |
스위치 매개 변수 |
중앙 관리 저장소 자체가 아니라 중앙 관리 저장소의 로컬 복제본에서 네트워크 사이트 정보를 검색합니다. |
입력 형식
없음.
반환 형식
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 유형의 개체를 검색합니다.
예제
-------------------------- 예제 1 --------------------------
Get-CsNetworkSite
Get-CsNetworkSite를 매개 변수 없이 호출하면 Microsoft Lync Server 2010 배포 내에 CAC 또는 E9-1-1에 대해 구성된 모든 네트워크 사이트가 반환됩니다.
-------------------------- 예제 2 --------------------------
Get-CsNetworkSite -Identity Redmond
이 명령은 Identity, 그리고 정의상 NetworkSiteID가 Redmond인 사이트를 검색합니다.
-------------------------- 예제 3 --------------------------
Get-CsNetworkSite -Filter NA*
예제 3의 명령은 Get-CsNetworkSite를 Filter 매개 변수를 사용하여 호출합니다. Filter 매개 변수의 값은 NA*로, 이는 문자열 NA로 시작하고 그 뒤에 문자(문자 수는 관계없음)가 오는 Identity를 가진 모든 사이트가 이 명령을 통해 검색됨을 의미합니다. 예를 들어 NARedmond, NAVancouver 및 NAChicago와 같은 사이트가 반환됩니다.
-------------------------- 예제 4 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"}
예제 4에서는 Get-CsNetworkSite와 Where-Object, 두 개의 cmdlet을 사용하여 NorthAmerica 지역에 속하는 모든 사이트를 검색합니다. 먼저 Get-CsNetworkSite를 매개 변수 없이 호출하여 모든 네트워크 사이트를 검색합니다. 그러면 이 사이트 컬렉션은 Where-Object에 파이프됩니다. Where-Object는 컬렉션을 필터링하면서 컬렉션에서 NetworkRegionID 속성이 NorthAmerica와 같은(-eq) 모든 사이트를 찾습니다.