Set-TSTMGMTObjectSecurity

Set the security of an object within the Management Platform.

Written by Giuseppe

Last published at: August 20th, 2020

Set the security of an object within the Management Platform


SYNTAX

Set-TSTMGMTObjectSecurity

-Objects <IObject[]> [-InheritenceDisabled <bool>] [-AddAce <TSTMGMTAddAce[]>] [-RemoveExisting] [-Interface <guid>] [-Timeout <int>]

Set-TSTMGMTObjectSecurity

-ObjectName <string> [-Force] [-InheritenceDisabled <bool>] [-AddAce <TSTMGMTAddAce[]>] [-RemoveExisting] [-Interface <guid>] [-Timeout <int>]

Set-TSTMGMTObjectSecurity

-ObjectId <guid> [-InheritenceDisabled <bool>] [-AddAce <TSTMGMTAddAce[]>][-RemoveExisting] [-Interface <guid>] [-Timeout <int>]


DESCRIPTION

Set the security of an object within the Management Platform, a new security object can be applied or the existing one can be updated.


EXAMPLES

1. Add an ACE to the existing security object on the 'Profiles\Powershell' folder

        Set-TSTMGMTObjectSecurity -ObjectName "\Profiles\Powershell" -AddAce $ace1


2. Replace all existing ACE objects with a new ACE on the 'Profiles\Powershell' folder

        Set-TSTMGMTObjectSecurity -ObjectName "\Profiles\Powershell" -AddAce $ace1 -RemoveExisting


PARAMETERS


-ObjectName

The fully qualified name of the object to set the security of

Type: String
Required: Yes
Accept Pipeline Input: No


-Objects

An array of objects to set the security of

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


-ObjectId

The GUID of the object to set the security of

Type: Guid
Required: Yes
Accept Pipeline Input: No


-InheritenceDisabled

Disabled inheritance on the object, blocking all security from parent objects

Type: Boolean
Required: No
Accept Pipeline Input: No


-AddAce

An array of TSTMGMTAddAce objects to apply

Type: ThinScale.Management.Powershell.TSTMGMTAddAce[]
Required: No
Accept Pipeline Input: No


-RemoveExisting

Remove all existing ACE objects

Type: SwitchParameter
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

ThinScale.Management.DataObjects.IObject[]


OUTPUTS

System.Object