Skip to content

Latest commit

 

History

History
184 lines (140 loc) · 4.71 KB

Invoke-AdfsFarmBehaviorLevelRaise.md

File metadata and controls

184 lines (140 loc) · 4.71 KB
description external help file Module Name ms.date online version schema title
Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
Microsoft.IdentityServer.Deployment.dll-Help.xml
ADFS
12/20/2016
2.0.0
Invoke-AdfsFarmBehaviorLevelRaise

Invoke-AdfsFarmBehaviorLevelRaise

SYNOPSIS

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

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

Type: PSCredential
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Force

Forces the command to run without asking for user confirmation.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-GroupServiceAccountIdentifier

Specifies the ID of a group Managed Service Account.

Type: String
Parameter Sets: AdfsUpgradeGmsaAccount
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Member

Specifies an array of members.

Type: String[]
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ServiceAccountCredential

Specifies credentials for a service account.

Type: PSCredential
Parameter Sets: AdfsUpgradeServiceAccount
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

NOTES

RELATED LINKS

Restore-AdfsFarmBehaviorLevel

Test-AdfsFarmBehaviorLevelRaise

Test-AdfsFarmBehaviorLevelRestore