Skip to content

Latest commit

 

History

History
148 lines (104 loc) · 3.33 KB

Remove-TeamViewerManagedDevice.md

File metadata and controls

148 lines (104 loc) · 3.33 KB

external help file: TeamViewerPS-help.xml Module Name: TeamViewerPS online version: https://github.com/teamviewer/TeamViewerPS/blob/main/Docs/Help/Remove-TeamViewerManagedDevice.md schema: 2.0.0

Remove-TeamViewerManagedDevice

SYNOPSIS

Remove a managed device from a managed group.

SYNTAX

Remove-TeamViewerManagedDevice [-APIToken] <SecureString> [-Device] <Object> [[-Group] <Object>] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DESCRIPTION

Removes a managed device from a managed group. The device remains in the pending status "leave" until it gets online and actually leaves the managed group. The current account needs DeviceAdministration manager permissions on the device.

EXAMPLES

Example 1

Remove-TeamViewerManagedDevice -Device 'c0cb303a-8a85-4e54-b657-a4757c791aef' -Group '9fd16af0-c224-4242-998e-a7138b038dbb'

Example 2

Remove-TeamViewerManagedDevice -DeviceId 'c0cb303a-8a85-4e54-b657-a4757c791aef' -GroupId '9fd16af0-c224-4242-998e-a7138b038dbb'

Removes the device from the managed group using the DeviceId and GroupId aliases.

Example 3

$group = Get-TeamViewerManagedGroup -Name 'Servers'
$group | Get-TeamViewerManagedDevice | Remove-TeamViewerManagedDevice -Group $group

Removes all devices of a managed group by piping them into the cmdlet.

PARAMETERS

-APIToken

The TeamViewer API access token.

Type: SecureString
Parameter Sets: (All)
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-Device

Object that can be used to identify the managed device. This can either be the managed device Id (as string or GUID) or a managed device object that has been received using other module functions.

Type: Object
Parameter Sets: (All)
Aliases: Id, DeviceId, ManagedDeviceId, ManagedDevice

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Group

Object that can be used to identify the managed group. This can either be the managed group Id (as string or GUID) or a managed group object that has been received using other module functions.

Type: Object
Parameter Sets: (All)
Aliases: GroupId, ManagedGroupId, ManagedGroup

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
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.Object

OUTPUTS

NOTES

RELATED LINKS