Get-AdfsRelyingPartyTrust

아티클
11/16/2015

Get-AdfsRelyingPartyTrust

Gets the relying party trusts of the Federation Service.

구문

Parameter Set: RelyingPartyName
Get-AdfsRelyingPartyTrust [[-Name] <String[]> ] [ <CommonParameters>]

Parameter Set: Identifier
Get-AdfsRelyingPartyTrust [-Identifier] <String[]> [ <CommonParameters>]

Parameter Set: PrefixIdentifier
Get-AdfsRelyingPartyTrust [-PrefixIdentifier] <String> [ <CommonParameters>]

자세한 설명

The Get-AdfsRelyingPartyTrust cmdlet gets the relying party trusts of the Federation Service. You can use this cmdlet with no parameters to get all relying party trust objects.

매개 변수

-Identifier<String[]>

Specifies an array of unique identifiers of the relying party trust to get.

별칭	없음
필수 여부	true
위치	1
기본값	없음
파이프라인 입력 적용 여부	true (ByValue)
와일드카드 문자 허용 여부	false

-Name<String[]>

Specifies the display name of the relying party trust to get.

별칭	없음
필수 여부	false
위치	1
기본값	없음
파이프라인 입력 적용 여부	true (ByValue, ByPropertyName)
와일드카드 문자 허용 여부	false

-PrefixIdentifier<String>

Specifies a prefix identifier of the relying party trust to get. The Federation Service uses prefix matching to support wildcard-type filtering and perform matches based on a specific prefix URL. The Federation Service performs matches by using string data type evaluation. Matches are not case-sensitive.

별칭	없음
필수 여부	true
위치	1
기본값	없음
파이프라인 입력 적용 여부	true (ByValue)
와일드카드 문자 허용 여부	false

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

None

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

Microsoft.IdentityServer.PowerShell.Resources.RelyingPartyTrust

A class structure that represents a relying party trust.

참고

If no Identifier parameter is provided, the cmdlet returns all RelyingPartyTrust objects. A relying party in AD FS(Active Directory Federation Services) 2.0 is an organization in which Web servers that host one or more Web-based applications reside. Tokens and Information Cards that originate from a claims provider can then be presented and ultimately consumed by the Web-based resources that are located in the relying party organization. When AD FS 2.0 is configured in the role of the relying party, it acts as a partner that trusts a claims provider to authenticate users. Therefore, the relying party consumes the claims that are packaged in security tokens that come from users in the claims provider. In other words, a relying party is the organization whose Web servers are protected by the resource-side federation server. The federation server at the relying party uses the security tokens that the claims provider produces to issue tokens to the Web servers that are located in the relying party.

예제

Example 1: Get property settings for a relying party trust by using a name

This command gets the property settings for the relying party trust named FabrikamApp.

PS C:\> Get-AdfsRelyingPartyTrust -Name "FabrikamApp"

Example 2: Get property settings for a relying party trust by using an identifier

This command gets the property settings for a relying party trust that has the identifier https://FabrikamApp.CentralServer.org.

PS C:\> Get-AdfsRelyingPartyTrust -Identifier "https://FabrikamApp.CentralServer.org"

Example 3: Get property settings for an updated relying party trust

This command gets the property settings for relying party trusts that have been updated in the last 24 hours.

PS C:\> Get-AdfsRelyingPartyTrust | Where-Object{ $_.LastUpdateTime -le (get-date).subtract((new-timespan -hours 24))}

Get-AdfsRelyingPartyTrust