Invoke-AdfsFarmBehaviorLevelRaise
Raises the behavior level of a farm.
Syntax
AdfsUpgradeServiceAccount (Default)
Invoke-AdfsFarmBehaviorLevelRaise
[-Member <String[]>]
[-Credential <PSCredential>]
[-ServiceAccountCredential <PSCredential>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AdfsUpgradeGmsaAccount
Invoke-AdfsFarmBehaviorLevelRaise
[-Member <String[]>]
[-Credential <PSCredential>]
[-GroupServiceAccountIdentifier <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Invoke-AdfsFarmBehaviorLevelRaise cmdlet raises the behavior level of an Active Directory Federation Services (AD FS) farm to enable the new features that are available in later versions of the Windows operating system.
To raise the behavior level of a farm that uses SQL Server as the policy database, specify the Credential parameter.
Examples
Example 1: Raise the farm behavior level
PS C:\> Invoke-AdfsFarmBehaviorLevelRaise
This command raises the farm behavior level from Windows Server 2012 R2 to the Windows Server 2016 level. The command applies to the latest version available on your forest. You not have to specify the level.
Example 2: Raise the farm behavior level for a farm that uses SQL Server
PS C:\> $Credentials = Get-Credential
PS C:\> Invoke-AdfsFarmBehaviorLevelRaise -Credential $Credentials
The first command prompts you for user name and password by using the Get-Credential cmdlet. The command stores the credentials in the $Credentials variable.
The second command raises the farm behavior level from Windows Server 2012 R2 to the Windows Server 2016 level. The cmdlet specifies the necessary credentials stored in $Credentials.
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 |
-Credential
Specifies credentials necessary to run this cmdlet for an AD FS farm that uses SQL Server as the policy database. The credentials provided must be an administrator on each AD FS server. To obtain a PSCredential object, use the Get-Credential cmdlet.
Parameter properties
| Type: | PSCredential |
| 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 |
-Force
Forces the command to run without asking for user confirmation.
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 |
-GroupServiceAccountIdentifier
Specifies the ID of a group Managed Service Account.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
AdfsUpgradeGmsaAccount
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Member
Specifies an array of members.
Parameter properties
| Type: | String[] |
| 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 |
-ServiceAccountCredential
Specifies credentials for a service account.
Parameter properties
| Type: | PSCredential |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
AdfsUpgradeServiceAccount
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| 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.