New-ADFSClaimRuleSet
New-ADFSClaimRuleSet
Creates a new set of claim rules.
Syntax
New-ADFSClaimRuleSet -ClaimRuleFile <string> [<CommonParameters>]
ClaimRuleFile
New-ADFSClaimRuleSet -ClaimRule <string[]> []
ClaimRule
Detailed Description
The New-ADFSClaimRuleSet cmdlet creates a new set of claim rules in Active Directory Federation Services (AD FS) 2.0.
Parameters
ClaimRule
Specifies the individual rules in this rule set.
Default Value: **
Data Type: string[]
Attributes
Name | Value | PSMAML Attribute |
---|---|---|
Required? |
true |
required |
Variable Length? |
true |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
Name | Value | PSMAML Attribute |
---|---|---|
Required? |
true |
required |
Variable Length? |
true |
variableLength |
ClaimRuleFile
Specifies the serialized policy text that is created by the collection of rules in the rule set.
Default Value: **
Data Type: string
Attributes
Name | Value | PSMAML Attribute |
---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
Name | Value | PSMAML Attribute |
---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Input Type
None
Return Type
Microsoft.IdentityServer.PowerShell.Resources.ClaimRuleSet
A class structure that represents a set of AD FS 2.0 claim rules.
Notes
- You can assign these claim rules to a claims provider trust or relying party trust by using the corresponding cmdlets.
Examples
-------------------------- EXAMPLE 1 --------------------------
Command Prompt: C:\PS>
$rSet = New-ADFSClaimRuleSet -ClaimRuleFile 'C:\ruleset.txt'
Set-ADFSRelyingPartyTrust -TargetName Fabrikam -IssuanceTransformRules $rSet.ClaimRulesString
Description
-----------
Creates a new claim rule set for a relying party trust using a text file.
-------------------------- EXAMPLE 2 --------------------------
Command Prompt: C:\PS>
$rSet = New-ADFSClaimRuleSet -ClaimRule 'c:[] => issue(claim = c);'
Set-ADFSRelyingPartyTrust -TargetName Fabrikam -IssuanceTransformRules $rSet.ClaimRulesString
Description
-----------
Creates a new claim rule set for a relying party trust using an inline AD FS 2.0 claims language rule.
See Also
Reference
Get-ADFSClaimsProviderTrust
Set-ADFSClaimsProviderTrust
Update-ADFSClaimsProviderTrust