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 ContosoAdminThis 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 |