COMMAND EVERYTHING.

Add-AdfsClaimsProviderTrust

Adds a new claims provider trust to the Federation Service.

Active Directory · Risk: High · Documentation Verified

Last verified: 2026-10-26

Microsoft ADFS reference: Adds a new claims provider trust to the Federation Service. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.

Add-AdfsClaimsProviderTrust -Name <String> [-AutoUpdateEnabled <Boolean>] [-AllowCreate <Boolean>]
 [-AnchorClaimType <String>] [-EncryptionCertificateRevocationCheck <String>] [-Enabled <Boolean>]
 [-Notes <String>] [-ProtocolProfile <String>] [-EncryptedNameIdRequired <Boolean>]
 [-SamlAuthenticationRequestIndex <UInt16>] [-SamlAuthenticationRequestParameters <String>]
 [-SamlAuthenticationRequestProtocolBinding <String>] [-SignatureAlgorithm <String>]
 [-SigningCertificateRevocationCheck <String>] [-PromptLoginFederation <PromptLoginFederation>]
 [-PromptLoginFallbackAuthenticationType <String>] [-RequiredNameIdFormat <Uri>]
 [-OrganizationalAccountSuffix <String[]>] [-MetadataUrl <Uri>] [-SignedSamlRequestsRequired <Boolean>]
 [-PassThru] [-AcceptanceTransformRules <String>] [-AcceptanceTransformRulesFile <String>]
 [-MonitoringEnabled <Boolean>] [-WhatIf] [-Confirm] [<CommonParameters>]

Copied 0 times

Required permissions

Use an account with the target resource permissions documented for Add-AdfsClaimsProviderTrust. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.

Supported environments

Windows / ADFS · Windows Server 2025 documentation; feature/module prerequisites apply

Parameters

-AcceptanceTransformRules: Specifies the claim acceptance transform rules for accepting claims from this claims provider. These rules determine the information that is accepted from the partner represented by the claims provider trust.
-AcceptanceTransformRulesFile: Specifies a file that contains the claim acceptance transform rules for accepting claims from the claims provider.
-AllowCreate: Indicates whether the Security Assertion Markup Language (SAML) parameter *AllowCreate* is sent in SAML requests to the claims provider. The default values $True.
-AutoUpdateEnabled: Indicates whether changes to the federation metadata by the *MetadataURL* parameter apply automatically to the configuration of the trust relationship. If this parameter has a value of $True, partner claims, certificates, and endpoints are updated automatically. Note: When auto-update is enabled, fields that can be overwritten by metadata become read only.
-ClaimOffered: Specifies an array of claims that are offered by this claims provider.
-Confirm: Prompts you for confirmation before running the cmdlet.
-Enabled: Indicates whether the claims provider trust is enabled or disabled.
-EncryptedNameIdRequired: Indicates whether the relying party requires that the NameID claim be encrypted. This setting applies to SAML logout requests.
-EncryptionCertificate: Specifies the certificate to be used for encrypting a NameID to this claims provider in SAML logout requests. Encrypting the NameID is optional.
-EncryptionCertificateRevocationCheck: Specifies the type of validation that occurs for the encryption certificate before it is used for encrypting claims. The acceptable values for this parameter are: - None - CheckEndCert - CheckEndCertCacheOnly - CheckChain - CheckChainCacheOnly - CheckChainExcludeRoot - CheckChainExcludeRootCacheOnly
-Identifier (required): Specifies the unique identifier for this claims provider trust. No other trust can use an identifier from this list. Uniform Resource Identifiers (URIs) are often used as unique identifiers for a claims provider trust, but you can use any string of characters.
-MetadataFile: Specifies a file path, such as c:\metadata.xml, that contains the federation metadata to be used when this claims provider trust is created.

Prerequisites

Windows with the ADFS module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.

Security considerations

This cmdlet changes system state. Review every target and parameter in the official reference, test outside production, and prepare an appropriate backup or rollback. Do not execute the example automatically.

Examples

Example 1: Add a claims provider trust

Add-AdfsClaimsProviderTrust -Name "Fabrikam" -MetadataURL "https://fabrikam.com/federationmetadata/2007-06/federationmetadata.xml"

This command adds a claims provider trust named Fabrikam that has the specified metadata URL to the Federation Service. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.

Sources

https://github.com/MicrosoftDocs/windows-powershell-docs/blob/b7645dd8c687139b28e845119da30ec670526507/docset/winserver2025-ps/ADFS/Add-AdfsClaimsProviderTrust.md

https://learn.microsoft.com/powershell/module/adfs/add-adfsclaimsprovidertrust?view=windowsserver2025-ps

Personal collections

Explain or customize this command with AI

Related commands

Get-ADComputer

Get-ADGroup

Get-ADGroupMember

Get-ADPrincipalGroupMembership