Modifier

Partager via

Set-AdfsDeviceRegistrationUpnSuffix

  • Reference
Module:
ADFS

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

SwitchParameter objects are received by the Force parameter.