Add-AdfsDeviceRegistrationUpnSuffix

Add-AdfsDeviceRegistrationUpnSuffix

Adds a custom UPN suffix.

Syntaxe

Parameter Set: Default
Add-AdfsDeviceRegistrationUpnSuffix [-UpnSuffix] <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Description détaillée

The Add-AdfsDeviceRegistrationUpnSuffix cmdlet adds a custom user principal name (UPN) suffix that you can use when you register a device with services de fédération Active Directory (AD FS).

In many environments, additional UPN suffixes for users are added after an services de fédération Active Directory (AD FS) deployment is complete. Run this cmdlet to support device registration for users of the new UPN suffix. The cmdlet configures a Secure Sockets Layer (SSL) binding that corresponds to the UPN suffix. The UPN suffix must have a corresponding registration name in the AD FS SSL certificate, for example enterpriseregistration.upn suffix. You can use a wild-card SSL certificate that covers all possible registration names.

Paramètres

-UpnSuffix<String>

Specifies a UPN suffix. The cmdlet adds and configures the UPN suffix that you specify as a valid registration UPN suffix.

Alias

none

Obligatoire ?

true

Position ?

1

Valeur par défaut

none

Accepter l’entrée de pipeline ?

True (ByValue)

Accepter les caractères génériques ?

false

-Confirm

Votre confirmation sera requise avant l’exécution de l’applet de commande.

Obligatoire ?

false

Position ?

named

Valeur par défaut

false

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-WhatIf

Présente les conséquences éventuelles de l’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Obligatoire ?

false

Position ?

named

Valeur par défaut

false

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.

  • string

Sorties

Le type de sortie est le type des objets émis par l’applet de commande.

Exemples

Example 1: Add a UPN suffix for registering a device

This command adds the UPN suffix Northamerica.Contoso.com to the list of suffixes that AD FS responds to for device registration requests after the initial deployment of the device registration service.

PS C:\> Add-AdfsDeviceRegistrationUpnSuffix -UpnSuffix "Northamerica.Contoso.com"

Rubriques connexes

Get-AdfsDeviceRegistrationUpnSuffix

Set-AdfsDeviceRegistrationUpnSuffix

Remove-AdfsDeviceRegistrationUpnSuffix