Move-TSTMGMTObject

Move an object 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-TSTMGMTObject

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

Move-TSTMGMTObject

        -Object <IObject> [-DestinationFolderName <string>] [-DestinationFolderId <guid>] [-Interface <guid>] [-Timeout <int>]


DESCRIPTION

Moves an object from the Management Platform. You can specify an ObjectType or ObjectName redirecting it into a DestinationFolderName or DestinationFolderId.


EXAMPLES

1. Move a site from a FOlder called 'Testing' to a folder called 'New'

        Move-TSTMGMTObject -ObjectType Site -DestinationFolderName '\Sites\New' -ObjectName '\Sites\ThinKiosk Site' 




        2. Move a device from a Folder called 'Testing Powershell' to a folder called 'Test2'

Move-TSTMGMTObject -ObjectType Device -DestinationFolderName '\Devices\Testing Powershell\Test2' -ObjectName '\Devices\Testing Powershell\W10_ULTRON' 


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


-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: String (GUID)
Required: No
Accept Pipeline Input: No


-Object

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

Type: ThinScale.Management.DataObjects.IObject
Required: Yes
Accept Pipeline Input: Yes


-ObjectName 

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

Type: String
Required: No
Accept Pipeline Input: No


-ObjectId

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

Type: String (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: String (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

ThinScale.Management.DataObjects.IObject


OUTPUTS

System.Object