Initialize-ADDeviceRegistration

Initializes the Device Registration Service configuration in the Active Directory forest.

Syntax

Initialize-ADDeviceRegistration
          -ServiceAccountName <String>
          [-DeviceLocation <String>]
          [-RegistrationQuota <UInt32>]
          [-MaximumRegistrationInactivityPeriod <UInt32>]
          [-Credential <PSCredential>]
          [-Force]
          [-DiscoveryName <String>]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Description

The Initialize-ADDeviceRegistration cmdlet initializes the Device Registration Service configuration in the Active Directory forest. To run this cmdlet, you must be logged in with enterprise administrator permissions and your Active Directory forest must have the Windows Server 2012 R2 schema. To join devices to a workplace, you must run the Enable-AdfsDeviceRegistration cmdlet on each Active Directory Federation Services (AD FS) server after this cmdlet has been run successfully.

Examples

Example 1: Initialize the Device Registration Service

PS C:\> Initialize-ADDeviceRegistration -ServiceAccountName "CONTOSO\svc_adfs" -DeviceLocation "Contoso.com" -RegistrationQuota 10 -MaximumRegistrationInactivityPeriod 90 -Credential ContosoAdmin

This command initializes the Device Registration Service in the Active Directory forest.

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

-Credential

Specifies a PSCredential object based on a user name and password. This account must be a member of the Enterprise Admins group. To obtain a PSCredential object, use the Get-Credential cmdlet. For more information, type Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeviceLocation

Specifies the domain in which to store the device objects. Specify a domain in the current forest.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiscoveryName

Specifies a discovery name.

Type:String
Position:Named
Default value:None
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:False
Accept wildcard characters:False

-MaximumRegistrationInactivityPeriod

Specifies the maximum number of days to elapse before a device object is deleted due to inactivity.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RegistrationQuota

Specifies the maximum number of devices that an individual user can register.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceAccountName

Specifies the account to which to grant read and write access to the Device Registration service configuration and containers in Active Directory.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
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