| external help file | TeamViewerPS-help.xml |
|---|---|
| Module Name | TeamViewerPS |
| online version | https://github.com/teamviewer/TeamViewerPS/blob/main/Docs/Help/Add-TeamViewerManager.md |
| schema | 2.0.0 |
Add a manager to a managed device or managed group.
Add-TeamViewerManager -ApiToken <SecureString> -AccountId <String> -Device <Object> [-Permissions <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
Add-TeamViewerManager -ApiToken <SecureString> -AccountId <String> -Group <Object> [-Permissions <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
Add-TeamViewerManager -ApiToken <SecureString> -Manager <Object> -Group <Object> [-Permissions <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
Add-TeamViewerManager -ApiToken <SecureString> -Manager <Object> -Device <Object> [-Permissions <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
Add-TeamViewerManager -ApiToken <SecureString> -User <Object> -Group <Object> [-Permissions <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
Add-TeamViewerManager -ApiToken <SecureString> -User <Object> -Device <Object> [-Permissions <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
Add-TeamViewerManager -ApiToken <SecureString> -UserGroup <Object> -Device <Object> [-Permissions <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
Add-TeamViewerManager -ApiToken <SecureString> -UserGroup <Object> -Group <Object> [-Permissions <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
Adds a manager to a managed device or a managed group. Managers can either be
identified by a TeamViewer account ID or their manager ID.
The current account (identified by the API access token) needs
ManagerAdministration manager permissions on the device/group.
PS /> Add-TeamViewerManager -Device 'c0cb303a-8a85-4e54-b657-a4757c791aef' -Manager '57e8f75e-8e6f-4450-a59d-10e02ccf5986'Add the manager with the given Manager ID to the managed device with the given device ID.
PS /> Add-TeamViewerManager -Group '9fd16af0-c224-4242-998e-a7138b038dbb' -Manager '57e8f75e-8e6f-4450-a59d-10e02ccf5986'Add the manager with the given Manager ID to the managed group with the given group ID.
PS /> Add-TeamViewerManager -Group '9fd16af0-c224-4242-998e-a7138b038dbb' -AccountId 1234Add the manager with the given TeamViewer account ID to the managed group with the given group ID.
TeamViewer account ID used to identify the manager to add.
Type: String
Parameter Sets: Device_ByAccountId, Group_ByAccountId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThe TeamViewer API access token.
Type: SecureString
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalsePrompts 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: FalseObject 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: Device_ByAccountId, Device_ByManagerId, Device_ByUserObject, Device_ByUserGroupId
Aliases: DeviceId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseObject 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: Group_ByAccountId, Group_ByManagerId, Group_ByUserObject, Group_ByUserGroupId
Aliases: GroupId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseObject that can be used to identify the manager to add. This can either be the manager ID (as string or GUID) or a manager object that has been received using other module function.
Type: Object
Parameter Sets: Group_ByManagerId, Device_ByManagerId
Aliases: ManagerId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseOptional permissions to give to the manager. By default, the manager receives an empty set of permissions, which still allows read-only access on the device/group data. Multiple values can be specified.
ManagerAdministration allows the manager to change other managers on the given
device or group.
DeviceAdministration (only for managed devices) allows the manager to change
device-specific properties, e.g. the device name. Also required to add devices
to managed groups.
GroupAdministration (only for managed groups) allows the manager to change
group-specific properties, e.g. the group name. Also required to add managed
devices to the group.
PolicyAdministration (only for managed devices) allows the manager to change
the policy that has been assigned to the managed device.
EasyAccess allows the manager to connect to the device (or the devices of the
group) via "EasyAccess" (without additional password).
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseUser object received by the Get-TeamViewerUser cmdlet. It can be used to
identify the manager that should be added to the device/group.
Type: Object
Parameter Sets: Group_ByUserObject, Device_ByUserObject
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseUserGroup object as returned from Get-TeamViewerUserGroup or Id of the UserGroup which should be added as manager of the targeted managed group or managed device.
Type: Object
Parameter Sets: Device_ByUserGroupId, Group_ByUserGroupId
Aliases: UserGroupId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseShows 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: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.