Set-AdfsDeviceRegistrationUpnSuffix
Sets the list of UPN suffixes.
Syntax
Set-AdfsDeviceRegistrationUpnSuffix
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Set-AdfsDeviceRegistrationUpnSuffix cmdlet sets the list of user principal name (UPN) suffixes that you can use when you register a device with Active Directory Federation Services (AD FS). The cmdlet discovers the UPN suffixes that are in use in the organization and configures the Secure Sockets Layer (SSL) bindings that correspond to the UPN suffix.
Any discovered UPN suffix must have a corresponding registration name in the SSL certificate for AD FS; for example, enterpriseregistration.
upn suffix.
You can also use a wildcard SSL certificate that covers all possible registration names.
This cmdlet does not affect the custom UPN suffixes that you set manually by running the Add-AdfsDeviceRegistrationUpnSuffix cmdlet.
Examples
Example 1: Set the list of UPN suffixes
PS C:\> Set-AdfsDeviceRegistrationUpnSuffix
This command sets the list of UPN suffixes that you can use when you register a device.
Example 2: Set the list of UPN suffixes without confirming
PS C:\> Set-AdfsDeviceRegistrationUpnSuffix -Force
This command sets the list of UPN suffixes without prompting you for confirmation.
Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Forces the command to run without asking for user confirmation.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
SwitchParameter objects are received by the Force parameter.