Get-CsConferenceDirectory
마지막으로 수정된 항목: 2012-03-23
조직에서 사용하도록 구성된 전화 회의 디렉터리에 대한 정보를 반환합니다. 전화 회의 디렉터리는 전화 접속 회의 사용자가 전화 회의 정보를 찾는 데 사용됩니다.
구문
Get-CsConferenceDirectory [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsConferenceDirectory [-Filter <String>] [-LocalStore <SwitchParameter>]
자세한 정보
전화 접속 회의 URI(Uniform Resource Identifier)를 만들면 이러한 URI에 고유한 SIP 주소가 할당됩니다. 그러나 SIP 주소는 SIP를 인식하지 않는 장치에서 변환하기 어렵습니다. 예를 들어 PSTN(공중 전화망) 전화는 SIP 주소를 변환할 수 없습니다. 따라서 Microsoft Lync Server 2010에서는 이러한 장치에서 전화 접속 회의를 찾아 연결하도록 도와줄 수 있는 방법으로 전화 회의 디렉터리를 사용합니다. 이를 위해 각 전화 접속 회의 URI와 연결되어 있고 SIP URI가 아닌 정수 값으로 식별된 SIP 전화 회의 디렉터리를 만듭니다. 이렇게 하면 PSTN 전화와 기타 장치가 전화 회의에 연결할 때 SIP URI 대신 이러한 번호를 사용할 수 있습니다. 실제로 디렉터리 번호는 사용자가 전화 접속 회의에 연결할 때 입력하는 PSTN 전화 회의 ID에 포함됩니다.
Get-CsConferenceDirectory cmdlet을 사용하면 조직에서 사용하도록 구성된 모든 전화 회의 디렉터리에 대한 정보를 반환할 수 있습니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalUserAdmins 및 RTCUniversalServerAdmins 그룹의 구성원은 Get-CsConferenceDirectory cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsConferenceDirectory"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds ID |
반환할 전화 회의 디렉터리의 숫자 식별자(예: 7)입니다. 이 매개 변수를 생략하면 Get-CsConferenceDirectory에서 조직에서 사용 중인 모든 전화 회의 디렉터리에 대한 정보를 반환합니다. |
Filter |
선택 |
문자열 |
와일드카드를 사용하여 검색할 전화 회의 디렉터리의 ID를 지정할 수 있습니다. 디렉터리 ID가 숫자이기 때문에 이 매개 변수는 최소한의 값으로 구성될 수 있습니다. 그러나 -Filter "3*" 구문은 Identity가 숫자 3으로 시작하는 모든 전화 회의 디렉터리를 반환합니다. |
LocalStore |
선택 |
스위치 매개 변수 |
중앙 관리 저장소 자체가 아니라 중앙 관리 저장소의 로컬 복제본에서 전화 회의 디렉터리 데이터를 검색합니다. |
입력 형식
없음. Get-CsConferenceDirectory는 파이프라인된 입력을 허용하지 않습니다.
반환 형식
Get-CsConferenceDirectory는 Microsoft.Rtc.Management.WritableConfig.Settings.PstnConf.ConferenceDirectories 개체의 인스턴스를 반환합니다.
예제
-------------------------- 예제 1 ------------------------
Get-CsConferenceDirectory
예제 1에 표시된 명령은 조직에서 사용하도록 구성된 모든 전화 회의 디렉터리에 대한 정보를 반환합니다.
-------------------------- 예제 2 ------------------------
Get-CsConferenceDirectory -Identity 2
예제 2에서는 Identity가 2인 전화 회의 디렉터리에 대한 정보를 반환합니다. Identity가 고유해야 하므로 이 명령은 둘 이상의 전화 회의 디렉터리를 반환하지 않습니다.
-------------------------- 예제 3 ------------------------
Get-CsConferenceDirectory | Where-Object {$_.ServiceID -match "UserServer:atl-cs-001.litwareinc.com"}
위 명령은 UserServer:atl-cs-001.litwareinc.com 서비스에 포함된 모든 전화 회의 디렉터리를 반환합니다. 이 작업을 수행하기 위해 이 명령은 먼저 매개 변수 없이 Get-CsConferenceDirectory를 호출하여 조직에서 찾은 모든 전화 회의 디렉터리 컬렉션을 반환합니다. 이 컬렉션은 ServiceID가 문자열 값 "UserServer:atl-cs-001.litwareinc.com"과 일치하는 디렉터리만 선택하는 Where-Object cmdlet에 파이프됩니다.