Move-TSTMGMTObjects

Move objects from one location to another within the Management Platform.

Written by Giuseppe

Last published at: August 20th, 2020

Move an object from one location to another within the Management Platform


SYNTAX

Move-TSTMGMTObjects

[[-DestinationFolderName] <string>] [[-DestinationFolderId] <guid>] [-ObjectType] {Folder | Device | Profile | Site | SoftwarePackage | Role | User | Broker | Notification | License} [[-Objects] <string[]>] [[-Guids] <guid[]>] [[-Force]][-Interface <guid>] [-Timeout <int>]


DESCRIPTION

Moves multiple objects from the Management Platform. You can specify an ObjectType,  redirecting it into a DestinationFolderName or DestinationFolderId.


EXAMPLES

1. Move 2 Devices from a folder using a FolderId into a folder called 'Test2'

Move-TSTMGMTObjects -DestinationFolderId 'D661EBF9-8793-4FA8-BB5E-BD5BFD62B072' -ObjectType Device -Objects '\Devices\Testing Powershell\Test2\W10','\Devices\Testing Powershell\Test2\W10_ULTRON'


        2. Move 2 Profiles from a folder using a folderName into a folder called 'Test2'

Move-TSTMGMTObjects -DestinationFolderName '\Profiles\Powershell\PS2' -ObjectType Profile -Objects '\Profiles\Powershell\Testing 2','\Profiles\Powershell\Testing 3'


PARAMETERS


-ObjectType

        The type of object being renamed ('Folder','Device','Profile','Site','SoftwarePackage','Role','User','Broker','Notification','License')

Type: String
Required: Yes
Accept Pipeline Input: No
Accepted values: Folder, Device, Profile, Site, SoftwarePackage, Role, User, Broker, Notification, License


-Objects

         A comma-delimited list of fully qualified object names to move

Type: String[]
Required: No
Accept Pipeline Input: No


-DestinationFolderName

The fully qualified name of the destination folder

Type: String
Required: No
Accept Pipeline Input: No


-DestinationFolderId 

The GUID of the destination folder (not required if destinationFolderName is supplied)

Type: Guid
Required: No
Accept Pipeline Input: No


-Guids

          A comma-delimited list of object GUID's to move (not required if objects are supplied)

Type: Guid[]
Required: No
Accept Pipeline Input: No


-Interface

The interface ID returned by a previously successful call to Connect-TSTMGMTServer. This parameter is only required if you are connected to 2 or more Management Platform instances at the same time. If this parameter is not specified the connection to the last successful call to Connect-TSTMgmtServer will be used.

Type: Guid
Required: No
Accept Pipeline Input: No


-Timeout

The time allowed in milliseconds for the call to complete before it is deemed to have timed out and is aborted

Type: Int32
Required: No
Accept Pipeline Input: No


-Force

        If multiple objects are found with the same name, the first retrieved will be used otherwise the call will fail

Type: SwitchParameter
Required: No
Accept Pipeline Input: No


INPUTS

None


OUTPUTS

System.Object