Set-AdfsNonClaimsAwareRelyingPartyTrust
Set-AdfsNonClaimsAwareRelyingPartyTrust
Sets the properties of a relying party trust for a non-claims-aware web application or service.
Syntax
Parameter Set: IdentifierName
Set-AdfsNonClaimsAwareRelyingPartyTrust [-TargetName] <String> [-AdditionalAuthenticationRules <String> ] [-AdditionalAuthenticationRulesFile <String> ] [-AlwaysRequireAuthentication] [-Identifier <String[]> ] [-IssuanceAuthorizationRules <String> ] [-IssuanceAuthorizationRulesFile <String> ] [-Name <String> ] [-Notes <String> ] [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: Identifier
Set-AdfsNonClaimsAwareRelyingPartyTrust -TargetIdentifier <String> [-AdditionalAuthenticationRules <String> ] [-AdditionalAuthenticationRulesFile <String> ] [-AlwaysRequireAuthentication] [-Identifier <String[]> ] [-IssuanceAuthorizationRules <String> ] [-IssuanceAuthorizationRulesFile <String> ] [-Name <String> ] [-Notes <String> ] [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: IdentifierObject
Set-AdfsNonClaimsAwareRelyingPartyTrust [-AdditionalAuthenticationRules <String> ] [-AdditionalAuthenticationRulesFile <String> ] [-AlwaysRequireAuthentication] [-Identifier <String[]> ] [-IssuanceAuthorizationRules <String> ] [-IssuanceAuthorizationRulesFile <String> ] [-Name <String> ] [-Notes <String> ] [-PassThru] [-TargetNonClaimsAwareRelyingPartyTrust <NonClaimsAwareRelyingPartyTrust> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Set-AdfsNonClaimsAwareRelyingPartyTrust cmdlet sets properties on a relying party trust for a non-claims-aware web application or service.
A non-claims aware relying party trust is a relying party trust for web applications or services that do not rely directly on Active Directory Federation Services (AD FS) to issue tokens, but instead rely on a third party that accesses such tokens and transforms them into what applications understand. A non-claims-aware relying party trust is useful for defining authentication and authorization policies for web applications and services that do not rely on AD FS tokens. The Web Application Proxy requests such tokens for preauthentication to web applications or services that have corresponding non-claims-aware relying party trusts for requests that come from outside the network through the proxy.
Parameters
-AdditionalAuthenticationRules<String>
Specifies rules for additional authentication for the relying party. For more information about the claims language for rules, see Understanding Claim Rule Language in AD FS 2.0 & Higher on TechNet.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-AdditionalAuthenticationRulesFile<String>
Specifies the file that contains all the rules for additional authentication for the relying party.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-AlwaysRequireAuthentication
Indicates that access requires authentication, even if this relying party has previously authenticated credentials for access. Specify this parameter to require users to always supply credentials to access sensitive resources.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Identifier<String[]>
Specifies an array of unique identifiers for the non-claims-aware relying party trust. No other trust can use an identifier from this list. As common practice, you can use Uniform Resource Identifiers (URIs) as unique identifiers for a relying party trust, or you can use any string.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-IssuanceAuthorizationRules<String>
Specifies the authorization rules for issuing claims to the relying party.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-IssuanceAuthorizationRulesFile<String>
Specifies the file that contains the authorization rules for issuing claims to the relying party.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies a name. The cmdlet adds the Web Application Proxy relying party trust that has the display name that you specify.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Notes<String>
Specifies a name. The cmdlet adds the Web Application Proxy relying party trust that has the display name that you specify.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-PassThru
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-TargetIdentifier<String>
Specifies the identifier of the non-claims-aware relying party trust to modify.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-TargetName<String>
Specifies the name of the non-claims-aware relying party trust to modify.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-TargetNonClaimsAwareRelyingPartyTrust<NonClaimsAwareRelyingPartyTrust>
Specifies a NonClaimsAwareRelyingPartyTrust object. The cmdlet removes the non-claims-aware relying party trust that you specify. To obtain a NonClaimsAwareRelyingPartyTrust, use the Get-AdfsNonClaimsAwareRelyingPartyTrust cmdlet.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Set the non-claims-aware relying party trust to always force authentication
This command sets the non-claims-aware relying party trust for the application named ExpenseReport to always force authentication.
PS C:\> Set-AdfsNonClaimsAwareRelyingPartyTrust -TargetName 'ExpenseReport' -AlwaysRequireAuthentication $True
Related topics
Get-AdfsNonClaimsAwareRelyingPartyTrust
Add-AdfsNonClaimsAwareRelyingPartyTrust
Enable-AdfsNonClaimsAwareRelyingPartyTrust