SYNOPSIS
Sets the properties of an AMS device
SYNTAX
Approve
Copy Set-AmsDevice -Id <String> [-Approve] [<CommonParameters>]
Reject
Copy Set-AmsDevice -Id <String> [-Reject] [-Force] [<CommonParameters>]
Enable
Copy Set-AmsDevice -Id <String> [-Enable] [<CommonParameters>]
Disable
Copy Set-AmsDevice -Id <String> [-Disable] [<CommonParameters>]
ExpirePassword
Copy Set-AmsDevice -Id <String> [-ExpirePassword] [<CommonParameters>]
DESCRIPTION
This cmdlet allows you to approve, reject, enable, disable or expire a device's password.
EXAMPLES
Example 1
Copy PS C:\> Set-AmsDevice -Id '10e051a4-6f08-4ac1-9fa5-2d62297137c8' -Approve
Approves a device by its ID
Example 2
Copy PS C:\> Get-AmsDevice -Name 'PC1' | Set-AmsDevice -Reject
Gets a device by its name and rejects it
PARAMETERS
-Approve
Approves the device's registration request
Copy Type: SwitchParameter
Parameter Sets: Approve
Aliases:
Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Disable
Disables the device, preventing it from communicating with AMS
Copy Type: SwitchParameter
Parameter Sets: Disable
Aliases:
Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Enable
Enables the device, allowing it to communicate with AMS
Copy Type: SwitchParameter
Parameter Sets: Enable
Aliases:
Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ExpirePassword
Indicates that the current password for the device should be marked as expired
Copy Type: SwitchParameter
Parameter Sets: ExpirePassword
Aliases:
Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Force
Rejects the device without prompting for confirmation
Copy Type: SwitchParameter
Parameter Sets: Reject
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Id
The unique ID of the device
Copy Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Reject
Rejects the device's registration request
Copy Type: SwitchParameter
Parameter Sets: Reject
Aliases:
Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
System.String
OUTPUTS
Lithnet.AccessManager.PowerShell.DevicePSObject
NOTES
Use of this cmdlet requires an Enterprise Edition license.
Last updated 9 months ago