Get-CsTrustedApplication

구문

Get-CsTrustedApplication [-Identity <ExternalApplicationIdentity>]

Get-CsTrustedApplication [-Filter <String>]

Get-CsTrustedApplication [-ApplicationId <String>] [-TrustedApplicationPoolFqdn <String>]

자세한 정보

신뢰할 수 있는 응용 프로그램은 Microsoft Lync Server 2010의 일부로 포함되어 기본 제공되지는 않지만 이 제품의 일부로 실행하도록 신뢰할 수 있는 상태가 지정된 타사에서 개발한 응용 프로그램입니다. 이 cmdlet을 사용하면 하나 이상의 신뢰할 수 있는 응용 프로그램에 대한 포트 및 GRUU(전역적으로 경로 지정 가능한 사용자 에이전트 URI) 설정을 검색할 수 있습니다.

이 cmdlet을 사용하여 신뢰할 수 있는 단일 응용 프로그램을 검색하려면 Identity 매개 변수 값을 제공해야 합니다. Identity는 응용 프로그램이 속해 있는 풀의 FQDN(정규화된 도메인 이름) 뒤에 슬래시(/)와 응용 프로그램 ID가 오는 형식으로 구성됩니다. 예를 들어 TrustPool.litwareinc.com/tapp2의 경우 TrustPool.litwareinc.com은 풀 FQDN이고, tapp2는 응용 프로그램 ID입니다. 이 cmdlet을 사용하여 응용 프로그램을 검색하면 TrustPool.litwareinc.com/urn:application:tapp2와 유사한 ID가 표시됩니다. 여기서 접두사 urn:application:이 응용 프로그램 이름(tapp2) 앞에 오는 것에 주의해야 합니다. 이 접두사는 Identity의 일부이므로 Identity 매개 변수 값을 지정할 때 별도로 입력하지 않아도 됩니다.

이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins 그룹의 구성원은 Get-CsTrustedApplication cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsTrustedApplication\b"}

매개 변수

입력 형식

없음.

반환 형식

Microsoft.Rtc.Management.Xds.DisplayTrustedApplication 유형의 개체를 반환합니다.

예제

-------------------------- 예제 1 --------------------------

Get-CsTrustedApplication

이 예제에서는 Lync Server 2010 배포 내에 정의된 모든 신뢰할 수 있는 응용 프로그램에 대한 정보를 검색합니다.

-------------------------- 예제 2 --------------------------

Get-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2

예제 2에서는 ID가 TrustPool.litwareinc.com/urn:application:tapp2인 신뢰할 수 있는 응용 프로그램을 검색합니다. Get-CsTrustedApplication은 자동으로 접두사를 추가하고 올바른 응용 프로그램을 검색하므로 접두사 urn:application:은 생략할 수 있습니다.

-------------------------- 예제 3 --------------------------

Get-CsTrustedApplication -Filter *trust*

예제 3에서는 Filter 값으로 지정된 와일드카드 문자열과 일치하는 ID를 가진 모든 신뢰할 수 있는 응용 프로그램을 검색합니다. 이 예제에서는 Filter 값 *trust*를 사용하여 ID에 문자열 “trust”가 포함된 모든 신뢰할 수 있는 응용 프로그램을 검색합니다. 이 문자열은 ID의 일부, 즉 풀 FQDN 또는 응용 프로그램 ID에 포함될 수 있습니다. 따라서 이 명령은 TrustedPool.litwareinc.com/urn:application:application1, Pool1.litwareinc.com/urn:application:trustedapp 및 Pool1.litwareinc.com/urn:application:trust와 같은 ID를 가진 신뢰할 수 있는 응용 프로그램을 검색합니다.

-------------------------- 예제 4 --------------------------

Get-CsTrustedApplication -ApplicationId tapp2 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com

예제 4에서는 Identity 매개 변수만 지정한 예제 2와 동일한 결과를 반환합니다. 다만, 예제 2에서는 신뢰할 수 있는 풀 FQDN 뒤에 응용 프로그램 ID가 오는 Identity를 기반으로 신뢰할 수 있는 응용 프로그램을 검색한 반면, 이 예제에서는 응용 프로그램 ID와 신뢰할 수 있는 풀 FQDN을 두 가지 별도의 매개 변수(ApplicationId 및 TrustedApplicationPoolFqdn) 값으로 입력했다는 점이 다릅니다.

-------------------------- 예제 5 ------------------------

Get-CsTrustedApplication | Where-Object {$_.TrustedApplicationPoolFqdn -eq "TrustPool.litwareinc.com"}

예제 5에서는 TrustPool.litwareinc.com 풀에 있는 모든 신뢰할 수 있는 응용 프로그램을 검색합니다. 이 작업을 수행하기 위해 먼저 Get-CsTrustedApplication cmdlet을 호출합니다. 그러면 Lync Server 배포 내에 정의된 모든 신뢰할 수 있는 응용 프로그램 컬렉션이 반환됩니다. 이 컬렉션은 컬렉션의 각 항목을 하나씩 확인하여 TrustedApplicationPoolFqdn 속성 값이 TrustPool.litwareinc.com과 같은(-eq) 항목을 찾는 Where-Object cmdlet에 파이프됩니다.

참고 항목

기타 리소스

New-CsTrustedApplication
Remove-CsTrustedApplication
Set-CsTrustedApplication