Set-AdfsDeviceRegistrationUpnSuffix
Set-AdfsDeviceRegistrationUpnSuffix
Sets the list of UPN suffixes.
Syntax
Parameter Set: Default
Set-AdfsDeviceRegistrationUpnSuffix [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed 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.
Parameters
-Force
Forces the command to run without asking for user confirmation.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
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.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
- switch
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Set the list of UPN suffixes
This command sets the list of UPN suffixes that you can use when you register a device.
PS C:\> Set-AdfsDeviceRegistrationUpnSuffix
Example 2: Set the list of UPN suffixes without confirming
This command sets the list of UPN suffixes without prompting you for confirmation.
PS C:\> Set-AdfsDeviceRegistrationUpnSuffix -Force
Related topics
Get-AdfsDeviceRegistrationUpnSuffix