SYNOPSIS
Sets the properties of a device registration key
SYNTAX
None (Default)
Copy Set-AmsDeviceRegistrationKey -Id <String> [-Name <String>] [-ActivationLimit <Int32>] [-ResetActivationCount]
[<CommonParameters>]
EnableApprovalRequired
Copy Set-AmsDeviceRegistrationKey -Id <String> [-Name <String>] [-Enable] [-ActivationLimit <Int32>]
[-ApprovalRequired] [-ResetActivationCount] [<CommonParameters>]
EnableApprovalNotRequired
Copy Set-AmsDeviceRegistrationKey -Id <String> [-Name <String>] [-Enable] [-ActivationLimit <Int32>]
[-ApprovalNotRequired] [-ResetActivationCount] [<CommonParameters>]
DisableApprovalRequired
Copy Set-AmsDeviceRegistrationKey -Id <String> [-Name <String>] [-Disable] [-ActivationLimit <Int32>]
[-ApprovalRequired] [-ResetActivationCount] [<CommonParameters>]
DisableApprovalNotRequired
Copy Set-AmsDeviceRegistrationKey -Id <String> [-Name <String>] [-Disable] [-ActivationLimit <Int32>]
[-ApprovalNotRequired] [-ResetActivationCount] [<CommonParameters>]
DESCRIPTION
This cmdlet allows you to set the properties of a device registration key
EXAMPLES
Example 1
Copy PS C:\> Set-AmsDeviceRegistrationKey -Id 'b88313dd-fafb-406f-8909-cac0c17c58e3' -Name "My new name" -ResetActivationCount
Changes the name of an activation key and resets its activation count
Example 2
Copy PS C:\ > Get-AmsDeviceRegistrationKey - Name "Head office device key" | Set-AmsDeviceRegistrationKey - Disable
Gets a registration key by its name and disables it.
PARAMETERS
-ActivationLimit
Specifies the number of times the key can be used
Copy Type : Int32
Parameter Sets : (All)
Aliases :
Required : False
Position : Named
Default value : None
Accept pipeline input : False
Accept wildcard characters : False
-ApprovalNotRequired
Specifies that devices can register without additional approval
Copy Type : SwitchParameter
Parameter Sets : EnableApprovalNotRequired, DisableApprovalNotRequired
Aliases :
Required : False
Position : Named
Default value : False
Accept pipeline input : False
Accept wildcard characters : False
-ApprovalRequired
Specifies that administrator approval is required for devices using this key
Copy Type : SwitchParameter
Parameter Sets : EnableApprovalRequired, DisableApprovalRequired
Aliases :
Required : False
Position : Named
Default value : False
Accept pipeline input : False
Accept wildcard characters : False
-Disable
Indicates if the key should be disabled
Copy Type : SwitchParameter
Parameter Sets : DisableApprovalRequired, DisableApprovalNotRequired
Aliases :
Required : False
Position : Named
Default value : False
Accept pipeline input : False
Accept wildcard characters : False
-Enable
Indicates if the key should be enabled
Copy Type : SwitchParameter
Parameter Sets : EnableApprovalRequired, EnableApprovalNotRequired
Aliases :
Required : False
Position : Named
Default value : False
Accept pipeline input : False
Accept wildcard characters : False
-Id
The ID of the key
Copy Type : String
Parameter Sets : (All)
Aliases :
Required : True
Position : Named
Default value : None
Accept pipeline input : True (ByPropertyName)
Accept wildcard characters : False
-Name
The name of the key
Copy Type : String
Parameter Sets : (All)
Aliases :
Required : False
Position : Named
Default value : None
Accept pipeline input : False
Accept wildcard characters : False
-ResetActivationCount
Specifies if the activation count of this key should be reset
Copy Type : SwitchParameter
Parameter Sets : (All)
Aliases :
Required : False
Position : Named
Default value : False
Accept pipeline input : False
Accept wildcard characters : False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters .
INPUTS
System.String
OUTPUTS
Lithnet.AccessManager.PowerShell.RegistrationKeyPSObject
NOTES
Use of this cmdlet requires an Enterprise Edition license.
RELATED LINKS