編集

次の方法で共有

Set-AdfsDeviceRegistrationUpnSuffix

Module:
ADFS Module

Sets the list of UPN suffixes.

Syntax

Default (Default) 

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.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Force

Forces the command to run without asking for user confirmation.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

SwitchParameter

SwitchParameter objects are received by the Force parameter.