Update-AdfsRelyingPartyTrust

Update-AdfsRelyingPartyTrust

Updates the relying party trust from federation metadata.

Syntaxe

Parameter Set: Identifier
Update-AdfsRelyingPartyTrust -TargetIdentifier <String> [-MetadataFile <String> ] [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: IdentifierName
Update-AdfsRelyingPartyTrust -TargetName <String> [-MetadataFile <String> ] [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: IdentifierObject
Update-AdfsRelyingPartyTrust -TargetRelyingParty <RelyingPartyTrust> [-MetadataFile <String> ] [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Description détaillée

The Update-AdfsRelyingPartyTrust cmdlet updates the relying party trust from the federation metadata that is available at the federation metadata URL. The cmdlet updates claims, endpoints, and certificates.

Paramètres

-MetadataFile<String>

Specifies a file path in UNC format. The file that you specify contains the federation metadata for the relying party application.

-PassThru

Retourne un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucun résultat.

-TargetIdentifier<String>

Specifies the identifier of the relying party trust to update.

-TargetName<String>

Specifies the name of the relying party trust to update.

-TargetRelyingParty<RelyingPartyTrust>

Specifies a RelyingPartyTrust object. The cmdlet updates the relying party trust that you specify. To obtain a RelyingPartyTrust object, use the Get-AdfsRelyingPartyTrust cmdlet.

-Confirm

Votre confirmation sera requise avant l’exécution de l’applet de commande.

-WhatIf

Présente les conséquences éventuelles de l’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.

• Microsoft.IdentityServer.PowerShell.Resources.RelyingPartyTrust

  A class structure that represents a relying party trust.

Sorties

Le type de sortie est le type des objets émis par l’applet de commande.

• None

Remarques

• A relying party in services de fédération Active Directory (AD FS) 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 you configure AD FS 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.

Exemples

Example 1: Update a relying party trust

This command updates the relying party trust named FabrikamApp.

PS C:\> Update-ADFSRelyingPartyTrust -TargetName "FarikamApp"

Rubriques connexes

Add-AdfsRelyingPartyTrust

Disable-AdfsRelyingPartyTrust

Enable-AdfsRelyingPartyTrust

Get-AdfsRelyingPartyTrust

Remove-AdfsRelyingPartyTrust

Set-AdfsRelyingPartyTrust