Get-CsSimpleUrlConfiguration
마지막으로 수정된 항목: 2012-03-23
조직에서 사용하도록 구성된 단순한 URL에 대한 정보를 반환합니다. 단순 URL을 사용하면 사용자가 모임 및 회의에 쉽게 참가하고, 관리자가 Microsoft Lync Server 2010 제어판에 쉽게 로그온할 수 있습니다.
구문
Get-CsSimpleUrlConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsSimpleUrlConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
자세한 정보
Microsoft Office Communications Server 2007 R2에서는 모임의 URL이 다음과 유사했습니다.
그러나 이러한 URL은 한 눈에 파악하기 힘들고 다른 사람에게 전달하기도 어렵습니다. Lync Server 2010에서 도입된 단순 URL은 다음과 같은 URL을 사용자에게 제공하여 이러한 문제를 해결합니다.
https://meet.litwareinc.com/kenmyer/071200
단순 URL은 Office Communications Server에서 사용되는 URL의 향상된 기능입니다. 하지만 단순 URL은 자동으로 만들어지지 않으며 사용자가 직접 URL을 구성해야 합니다. 또한 각 URL에 대해 DNS(Domain Name System) 레코드를 만들고, 외부 액세스에 대한 역방향 프록시 규칙을 구성하고, 프런트 엔드 서버 인증서에 단순 URL을 추가하는 등의 작업을 수행해야 합니다.
Lync Server에서는 세 가지 유형의 단순 URL을 만들 수 있습니다.
Meet – 모임에 사용됩니다. 각 SIP 도메인에 Meet URL이 하나 이상 있어야 합니다.
Admin - 관리자에게 Lync Server 2010 제어판을 안내하는 데 사용됩니다.
Dialin - 전화 접속 회의 웹 페이지에 사용됩니다.
단순 URL은 단순 URL 구성 컬렉션에 저장됩니다. Lync Server를 설치하면 글로벌 컬렉션이 만들어지는데, 사이트 범위에서 사용자 지정 컬렉션을 만들 수도 있습니다. 이렇게 하면 각 사이트마다 다른 단순 URL을 사용할 수 있습니다.
Get-CsSimpleUrlConfiguration cmdlet을 사용하면 조직에서 현재 사용 중인 모든 단순 URL 구성 컬렉션에 대한 정보를 검색할 수 있습니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalUserAdmins 및 RTCUniversalServerAdmins 그룹의 구성원은 Get-CsSimpleUrlConfiguration cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsSimpleUrlConfiguration"}
매개 변수
매개 변수 | 필수 | 유형 | 설명 |
---|---|---|---|
Identity |
선택 |
Xds ID |
반환할 단순 URL 컬렉션의 고유 식별자입니다. 글로벌 컬렉션을 반환하려면 -Identity global 구문을 사용합니다. 사이트 범위에서 컬렉션을 반환하려면 -Identity "site:Redmond"와 유사한 구문을 사용합니다. ID를 지정할 때는 와일드카드를 사용할 수 없습니다. 와일드카드를 사용하려면 Filter 매개 변수를 대신 사용합니다. Get-CsSimpleUrlConfiguration을 매개 변수 없이 호출하면 조직에서 사용하도록 구성된 모든 단순 URL이 반환됩니다. |
Filter |
선택 |
문자열 |
반환할 단순 URL 컬렉션을 지정하기 위해 와일드카드 문자를 사용할 수 있습니다. 예를 들어 사이트 범위에서 적용된 모든 구성 설정의 컬렉션을 반환하려면 -Filter "site:*" 구문을 사용합니다. Filter 매개 변수와 Identity 매개 변수를 같은 명령에 함께 사용할 수 없습니다. |
Tenant |
선택 |
GUID |
이 매개 변수는 온-프레미스 버전의 Lync Server 2010에는 사용되지 않습니다. |
LocalStore |
선택 |
스위치 매개 변수 |
중앙 관리 저장소 자체가 아니라 중앙 관리 저장소의 로컬 복제본에서 단순 URL 구성 데이터를 검색합니다. |
입력 형식
없음.
반환 형식
Get-CsSimpleUrlConfiguration은 Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration 개체의 인스턴스를 반환합니다.
예제
-------------------------- 예제 1 ------------------------
Get-CsSimpleUrlConfiguration
위 명령은 조직에서 현재 사용되고 있는 모든 단순한 URL 구성 컬렉션에 대한 정보를 반환합니다. 이를 위해 Get-CsSimpleUrlConfiguration을 추가 매개 변수 없이 호출합니다.
-------------------------- 예제 2 ------------------------
Get-CsSimpleUrlConfiguration -Identity "site:Redmond"
예제 2에서는 단일의 단순한 URL 구성 컬렉션인, Identity가 site:Redmond인 구성에 대한 정보가 반환됩니다.
-------------------------- 예제 3 ------------------------
Get-CsSimpleUrlConfiguration -Filter "site:*"
예제 3에서는 사이트 범위에 할당된 모든 단순한 URL 구성 컬렉션에 대한 정보를 반환합니다. 이를 위해 Get-CsSimpleUrlConfiguration을 Filter 매개 변수와 함께 호출합니다. 필터 값 "site:*"는 반환된 데이터를 문자열 값 "site:"으로 시작하는 ID를 가진 컬렉션으로 제한합니다.
-------------------------- 예제 4 ------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl
예제 4에서는 조직에서 사용하도록 구성된 각 단순 URL에 대한 세부 정보를 표시합니다. 이 작업을 수행하기 위해 먼저 Get-CsSimpleUrlConfiguration을 호출하여 전체 단순 URL 정보 집합을 반환합니다. 이 데이터는 ExpandProperty 매개 변수를 사용하여 SimpleUrl 속성 값을 "확장"하는 Select-Object cmdlet에 파이프됩니다. 속성 값을 확장하면 해당 속성에 저장된 모든 데이터가 읽기 쉬운 형식으로 표시됩니다.
-------------------------- 예제 5 ------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl | Where-Object {$_.Component -eq "Meet"}
예제 5에 표시된 명령은 조직에서 현재 사용 중인 모임 관리에 대한 모든 단순 URL을 반환합니다. 이를 위해 먼저 Get-CsSimpleUrlConfiguration을 추가 매개 변수 없이 호출합니다. 이 명령은 단순 URL 정보의 전체 집합을 반환합니다. 이 데이터는 ExpandProperty 매개 변수를 사용하여 SimpleUrl 속성 값을 확장하는 Select-Object cmdlet에 파이프됩니다. 이 필터링된 컬렉션은 Component 속성이 "Meet"와 같은 단순 URL만 선택하는 Where-Object에 파이프됩니다.