Get-CsPartnerApplication

Skype for Business Server 2015
 

마지막으로 수정된 항목: 2017-03-28

조직에서 사용하도록 구성된 모든 파트너 응용 프로그램에 대한 정보를 반환합니다. 파트너 응용 프로그램은 비즈니스용 Skype 서버 2015에서 타사 보안 토큰 서버를 사용하여 보안 토큰을 교환하지 않고 토큰을 직접 교환할 수 있는 응용 프로그램입니다. 이 cmdlet은 Lync Server 2013에서 도입되었습니다.

Get-CsPartnerApplication [-Identity <XdsGlobalRelativeIdentity>] <COMMON PARAMETERS>
Get-CsPartnerApplication [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>] [-Tenant <Guid>]

예제 1의 명령은 조직에서 사용하도록 구성된 모든 파트너 응용 프로그램에 대한 정보를 반환합니다.

Get-CsPartnerApplication

예제 2에서는 ID가 MicrosoftExchange인 파트너 응용 프로그램에 대한 정보를 반환합니다.

Get-CsPartnerApplication -Identity "MicrosoftExchange"

예제 3에서는 응용 프로그램 식별자가 "microsoft.exchange"인 모든 파트너 응용 프로그램에 대한 정보를 반환합니다. 이 작업을 수행하기 위해 명령은 먼저 매개 변수 없이 Get-CsPartnerApplication cmdlet을 호출합니다. 그러면 구성되어 있는 모든 파트너 응용 프로그램의 컬렉션이 반환됩니다. 해당 컬렉션은 Where-Object cmdlet에 파이프되며, 이 cmdlet은 ApplicationIdentifier 속성이 "microsoft.exchange"인 파트너 응용 프로그램만 선택합니다.

Get-CsPartnerApplication | Where-Object {$_.ApplicationIdentifier -eq "microsoft.exchange"}

예제 4에서는 현재 사용하지 않도록 설정되어 있는 모든 파트너 응용 프로그램에 대한 정보를 반환합니다. 이 작업을 수행하기 위해 명령은 먼저 Get-CsPartnerApplication cmdlet을 호출하여 모든 파트너 응용 프로그램(사용하도록 설정/사용하지 않도록 설정)의 컬렉션을 반환합니다. 해당 컬렉션은 Where-Object cmdlet에 파이프되며, 이 cmdlet은 Enabled 속성이 False인 응용 프로그램만 선택합니다.

Get-CsPartnerApplication | Where-Object {$_.Enabled -eq $False}

비즈니스용 Skype 서버 2015에서는 비즈니스용 Skype 서버 2015와 Exchange이 정보를 공유할 수 있도록 하는 인증과 같은 서버 간 인증이 OAuth 보안 프로토콜을 사용하여 수행됩니다. 이러한 인증 유형에서는 보통 서로 통신해야 하는 서버 2대(서버 A와 B) 및 제3의 보안 토큰 서버 등 총 3대의 서버가 필요합니다. 서버 A와 B는 서로 통신해야 하는 경우 OAuth 서버라고도 하는 토큰 서버에 연결하여 두 서버가 신원을 증명하기 위해 교환할 수 있는 상호 트러스트된 보안 토큰을 가져옵니다.

온-프레미스 버전의 비즈니스용 Skype 서버 2015를 사용 중인데 OAuth 프로토콜을 완벽하게 지원하는 다른 서버 제품(예: Exchange 또는 SharePoint)과 통신해야 하는 경우에는 대개 토큰 서버를 사용할 필요가 없습니다. 이러한 서버 제품은 자체 보안 토큰을 직접 발급할 수 있기 때문입니다. 그러나 Exchange 등의 다른 서버 제품을 파트너 응용 프로그램으로 구성해야 하며 다른 서버 제품에 대해 비즈니스용 Skype 서버 2015를 파트너 응용 프로그램으로 구성해야 합니다. 비즈니스용 Skype 서버 2015에서는 CsPartnerApplication cmdlet을 사용하여 파트너 응용 프로그램을 관리합니다.

사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 반환하려면 Windows PowerShell 명령줄 인터페이스 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPartnerApplication"}

비즈니스용 Skype 서버 제어판: Get-CsPartnerApplication cmdlet에 의해 수행되는 기능은 비즈니스용 Skype 서버 제어판에서는 사용할 수 없습니다.

 

매개 변수 필수 형식 설명

Filter

선택

System.String

하나 이상의 파트너 응용 프로그램을 반환하기 위해 와일드카드 값을 사용할 수 있습니다. 예를 들어 ID에 문자열 값 "Microsoft"가 포함된 모든 파트너 응용 프로그램을 반환하려면 다음 구문을 사용합니다.

-Filter "*Microsoft*"

Filter 매개 변수와 Identity 매개 변수를 같은 명령에 함께 사용할 수는 없습니다.

Identity

선택

Microsoft.Rtc.Management.Xds.XdsGlobalRelativeIdentity

파트너 응용 프로그램의 고유 식별자입니다. 예를 들면 다음과 같습니다.

-Identity "MicrosoftExchange"

Identity 매개 변수와 Filter 매개 변수를 모두 명령에 포함하지 않으면 Get-CsPartnerApplication cmdlet은 모든 파트너 응용 프로그램에 대한 정보를 반환합니다.

LocalStore

선택

System.Management.Automation.SwitchParameter

중앙 관리 저장소 자체가 아니라 중앙 관리 저장소의 로컬 복제본에서 파트너 응용 프로그램 데이터를 검색합니다.

Tenant

선택

System.Guid

해당 파트너 응용 프로그램 설정을 검색할 비즈니스용 Skype 온라인 테넌트 계정의 GUID(Globally Unique Identifier)입니다.

예를 들면 다음과 같습니다.

–Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

다음 명령을 실행하여 각 테넌트에 대해 테넌트 ID를 반환할 수 있습니다.

Get-CsTenant | Select-Object DisplayName, TenantID

없음. Get-CsPartnerApplication cmdlet은 파이프라인된 입력을 허용하지 않습니다.

Get-CsPartnerApplication cmdlet은 Microsoft.Rtc.Management.WritableConfig.Settings.SSAuth.PartnerApplication#Decorated 개체의 인스턴스를 반환합니다.

 
표시: