Get-CsTrustedApplicationEndpoint
마지막으로 수정된 항목: 2012-03-23
하나 이상의 신뢰할 수 있는 응용 프로그램 끝점에 대한 정보를 검색합니다.
구문
Get-CsTrustedApplicationEndpoint [-Identity <UserIdParameter>] [-ApplicationId <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-TrustedApplicationPoolFqdn <String>]
자세한 정보
신뢰할 수 있는 응용 프로그램 끝점은 신뢰할 수 있는 응용 프로그램으로 통화를 경로 지정할 수 있는 Active Directory 대화 상대 개체입니다. 이 cmdlet은 AD DS(Active Directory 도메인 서비스)에서 하나 이상의 기존 끝점 대화 상대 개체를 검색합니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalUserAdmins 및 RTCUniversalServerAdmins 그룹의 구성원은 Get-CsTrustedApplicationEndpoint cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsTrustedApplicationEndpoint"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
사용자 ID 매개 변수 |
수정할 응용 프로그램 끝점의 ID(고유 이름), SIP 주소 또는 표시 이름입니다. |
Filter |
선택 |
문자열 |
Microsoft Lync Server 2010에 대한 특정 특성을 필터링하여 반환되는 데이터를 제한하는 데 사용됩니다. 예를 들어 표시 이름 또는 SIP 주소가 특정 와일드카드 패턴과 일치하는 대화 상대에 대한 데이터만 반환하도록 제한할 수 있습니다. Filter 매개 변수는 Where-Object cmdlet에 사용되는 구문과 동일한 Windows PowerShell 필터링 구문을 사용합니다. 예를 들어 Enterprise Voice를 사용하도록 설정된 대화 상대만 반환하는 필터는 {EnterpriseVoiceEnabled -eq $True}와 같이 나타납니다. 여기서 EnterpriseVoiceEnabled는 Active Directory 특성을 나타내고 -eq는 비교 연산자(같음)를 나타내며 $True(기본 제공 Windows PowerShell 변수)는 필터 값을 나타냅니다. |
ApplicationId |
선택 |
문자열 |
검색할 끝점에서 신뢰할 수 있는 응용 프로그램의 응용 프로그램 ID입니다. |
Credential |
선택 |
PS 자격 증명 |
끝점을 검색하는 데 사용할 대체 자격 증명입니다. Get-Credential cmdlet을 호출하여 PSCredential 개체를 검색할 수 있습니다. |
DomainController |
선택 |
Fqdn |
도메인 컨트롤러를 지정하는 데 사용됩니다. 도메인 컨트롤러가 지정되지 않은 경우 사용 가능한 첫 번째 도메인 컨트롤러가 사용됩니다. |
OU |
선택 |
OU ID 매개 변수 |
끝점이 상주한 OU입니다. |
ResultSize |
선택 |
제한 없음 |
검색할 끝점 레코드의 최대 수입니다. |
TrustedApplicationPoolFqdn |
선택 |
문자열 |
검색할 끝점의 응용 프로그램과 연결된 신뢰할 수 있는 응용 프로그램 풀의 FQDN(정규화된 도메인 이름)입니다. |
입력 형식
문자열. 사용자 계정의 ID를 나타내는 파이프라인된 문자열 값을 허용합니다.
반환 형식
Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 개체 유형을 검색합니다.
예제
-------------------------- 예제 1 --------------------------
Get-CsTrustedApplicationEndpoint
이 예제에서는 Lync Server 2010 배포 내에 정의된 모든 신뢰할 수 있는 응용 프로그램 끝점에 대한 정보를 검색합니다.
-------------------------- 예제 2 --------------------------
Get-CsTrustedApplicationEndpoint -Identity "sip:endpoint1@litwareinc.com"
예제 2에서는 SIP 주소가 endpoint1@litwareinc.com인 응용 프로그램 끝점 대화 상대에 대한 정보를 검색합니다. sip: 접두사는 SIP 주소를 ID로 사용할 때 필요합니다.
-------------------------- 예제 3 --------------------------
Get-CsTrustedApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}
예제 3에서는 표시 이름에 “endpoint” 문자열이 있는 모든 신뢰할 수 있는 응용 프로그램 끝점을 검색합니다. 이 작업을 수행하기 위해 명령은 Filter 매개 변수를 사용합니다. 이 매개 변수 값은 필터링을 통해 문자열 endpoint(*endpoint* - 와일드카드 문자는 endpoint라는 문자열 앞 또는 뒤에 어떤 문자라도 올 수 있음을 나타내며, 이는 endpoint가 표시 이름 내의 아무 데나 있어도 됨을 의미함)가 포함된(-like) 표시 이름(DisplayName)을 가진 끝점 개체를 찾습니다.
-------------------------- 예제 4 --------------------------
Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Select-Object SipAddress, DisplayName, OwnerUrn
예제 4에서는 tapp2 응용 프로그램에 연결된 모든 신뢰할 수 있는 응용 프로그램 끝점을 반환합니다. 이 작업을 수행하기 위해 ID tapp2를 ApplicationId 매개 변수에 전달합니다. 풀 FQDN은 지정하지 않습니다. 이는 ID가 tapp2인 응용 프로그램이 둘 이상의 풀에 있는 경우 이러한 모든 응용 프로그램의 끝점이 검색된다는 의미입니다. 이 명령의 다음 부분은 반환된 개체를 이러한 개체의 SipAddress, DisplayName 및 OwnerUrn 속성만 표시하는 Select-Object cmdlet에 파이프합니다.