Edit

Share via


Disable-AdfsNonClaimsAwareRelyingPartyTrust

Disables a relying party trust for a non-claims-aware web application or service from the Federation Service.

Syntax

IdentifierName (Default)

Disable-AdfsNonClaimsAwareRelyingPartyTrust
    [-TargetName] <String>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Identifier

Disable-AdfsNonClaimsAwareRelyingPartyTrust
    -TargetIdentifier <String>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

IdentifierObject

Disable-AdfsNonClaimsAwareRelyingPartyTrust
    -TargetNonClaimsAwareRelyingPartyTrust <NonClaimsAwareRelyingPartyTrust>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Disable-AdfsNonClaimsAwareRelyingPartyTrust cmdlet disables a relying party trust for a non-claims-aware web application or service from the Federation Service. When you disable a relying party trust, no authentication is allowed. Non-claims-aware relying party trusts for applications that are published through the Web Application Proxy that are disabled prevent clients from reaching the application.

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 pre-authentication 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.

Examples

Example 1: Disable a relying party trust by using a name

PS C:\> Disable-AdfsNonClaimsAwareRelyingPartyTrust -TargetName "ExpenseReport"
45495

This command disables the expense report relying party trust named ExpenseReport.

Example 2: Disable a report relying party trust by using an identifier

PS C:\> Disable-AdfsNonClaimsAwareRelyingPartyTrust -TargetIdentifier "https://Contosoexpense/"

This command disables the expense report relying party trust that has the identifier https://Contosoexpense.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-TargetIdentifier

Specifies the identifier of the non-claims-aware relying party trust to disable.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Identifier
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-TargetName

Specifies the name of the non-claims-aware relying party trust to disable.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

IdentifierName
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-TargetNonClaimsAwareRelyingPartyTrust

Specifies a NonClaimsAwareRelyingPartyTrust object. The cmdlet disables the non-claims-aware relying party trust that you specify. To obtain a NonClaimsAwareRelyingPartyTrust, use the Get-AdfsNonClaimsAwareRelyingPartyTrust cmdlet.

Parameter properties

Type:NonClaimsAwareRelyingPartyTrust
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

IdentifierObject
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.