Add-AdfsDeviceRegistrationUpnSuffix

Add-AdfsDeviceRegistrationUpnSuffix

Adds a custom UPN suffix.

Sintaxis

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

Descripción detallada

The Add-AdfsDeviceRegistrationUpnSuffix cmdlet adds a custom user principal name (UPN) suffix that you can use when you register a device with Servicios de federación de Active Directory (AD FS).

In many environments, additional UPN suffixes for users are added after an Servicios de federación de 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.

Parámetros

-UpnSuffix<String>

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

Alias

ninguno

¿Requerido?

true

¿Posición?

1

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByValue)

¿Aceptar caracteres comodín?

false

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

falso

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

falso

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.

  • string

Salidas

El tipo de resultado es el tipo de objetos que emite el cmdlet.

Ejemplos

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"

Temas relacionados

Get-AdfsDeviceRegistrationUpnSuffix

Set-AdfsDeviceRegistrationUpnSuffix

Remove-AdfsDeviceRegistrationUpnSuffix