Places a resource under governance.
Syntax:
Set-QDataUnderGovernance [-ManagedHostId] <String> [-ResourceType] <String> [-ResourceUri] <String> [[-DisplayPath] [<String>]] [[-EmployeeName] [<String>]] [[-EmployeeId] [<String>]] [[OwnerRoleFullPath] [<String>]] [[-OwnerRoleId] [<String>]] [[-PublishToITShop] [<Boolean>]] [[-UseBackingFolderSecurity] [<SwitchParameter>]] [[-Reset] [<SwitchParameter>]] [[-SharePointDisplayPath] [<String>]] [[-ManagedResourceId] [<String>]] [<CommonParameters>]
Parameter | Description |
---|---|
ManagedHostId |
Specify the ID (GUID format) of the managed host where the resource to be placed under governance is located. Run the Get-QManagedHosts cmdlet without any parameters to retrieve a list of available managed hosts and their IDs. |
ResourceType |
Specify the type of resource to be placed under governance. Valid values include:
|
ResourceUri |
Specify the Uri for the resource to be placed under governance. For NTFS files and folders, use the form: \\MACHINE\$DRIVELETTER\PathToResource For SharePoint, enter the FARM GUID, Site collection GUID (that is, sp://titan/0ee296d6-dea5-4f4d-950f-27c06458cad1/57947f70-c2b0-4d76-a8b3-ac54fa5bb4ab/203a4c04-4f0e-4d6a-84a7-c2ef0a3f02e3/Dereks%20Site/Shared%20Documents/SharePoint/desktop.ini) |
DisplayPath | (Optional) Specify the path of the resource to be displayed in the Manager. This is useful for long paths. |
EmployeeName |
(Optional) Specify the name of the employee who is set as the business owner of the current governed resource. NOTE: Specify only one of the following parameters: EmployeeName, EmployeeId, OwnerRoleFullPath, or OwnerRoleId. |
EmployeeId |
(Optional) Specify the ID (GUID format) of the employee who is set as the business owner of the current governed resource. NOTE: Specify only one of the following parameters: EmployeeName, EmployeeId, OwnerRoleFullPath, or OwnerRoleId. |
OwnerRoleFullPath |
(Optional) Specify the full path of the application role who is set as the business owner of the current governed resource. NOTE: Specify only one of the following parameters: EmployeeName, EmployeeId, OwnerRoleFullPath, or OwnerRoleId. |
OwnerRoleId |
(Optional) Specify the ID (GUID format) of the application role who is set as the business owner of the current governed resource. NOTE: Specify only one of the following parameters: EmployeeName, EmployeeId, OwnerRoleFullPath, or OwnerRoleId. |
PublishToITShop |
(Optional) Specify this parameter to place the resource under governance and add it to the IT Shop. Valid values are:
|
UsingBackingFolderSecurity |
(Optional) Specify this parameter to indicate the security for the backing folder is to be used. |
Reset |
(Optional) Specify this parameter to indicate whether you want to reset the governed resource record if it already exists in the database. Valid values are:
|
SharePointDisplayPath | (Optional) Specify the readable SharePoint path (that is, SharePoint_ConfigVmset6/SharePoint - 80/Site/Shared Documents/SharePoint) to be displayed in the Manager. |
ManagedResourceId | (Optional) Specify this parameter to link the QAMDuG entry to a QAMManagedResource record in the database. |
Examples:
Example | Description |
---|---|
Set-QDataUnderGovernance -managedhostid 68CD6FFC-BA2C-4F8E-8C34-70D2C1C1995A -ResourceType "NTFS\Folder" -ResourceUri \\qamautomem1\C$\autoroot\DUG\Folder2 |
This example places the resource \\qamautomem1\C$\autoroot\DUG\Folder2 under governance for the managed host identified by 68CD6FFC-BA2C-4F8E-8C34-70D2C1C1995A. |
Set-QDataUnderGovernance -managedhostid 68CD6FFC-BA2C-4F8E-8C34-70D2C1C1995A -ResourceType "NTFS\Folder" -ResourceUri \\qamautomem1\C$\autoroot\DUG\Folder2 -EmployeeName "Admin, Admin" -Reset $true |
This example places the resource \\qamautomem1\C$\autoroot\DUG\Folder2 under governance for the managed host identified by 68CD6FFC-BA2C-4F8E-8C34-70D2C1C1995A. It also sets the employee whose name is "Admin, Admin" as the business owner of this governed resource. If this governed resource already exists, it would be reset. |
Set-QDataUnderGovernance -managedhostid 68CD6FFC-BA2C-4F8E-8C34-70D2C1C1995A -ResourceType "NTFS\Folder" -ResourceUri \\qamautomem1\C$\autoroot\DUG\Folder2 -OwnerRoleId "81d50b9e-7ab6-43c0-8016-da972e633303" -Reset $true |
This example places the resource \\qamautomem1\C$\autoroot\DUG\Folder2 under governance for the managed host identified by 68CD6FFC-BA2C-4F8E-8C34-70D2C1C1995A. It also sets the role whose Id is "81d50b9e-7ab6-43c0-8016-da972e633303" as the business owner of this governed resource. If this governed resource already exists, it would be reset. |
Set-QDataUnderGovernance -managedhostid ca990043-8ffc-4eea-8e11-179a1d3505af -ResourceType SharePoint\ListItem -ResourceURI 'sp://titan/0ee296d6-dea5-4f4d-950f-27c06458cad1/57947f70-c2b0-4d76-a8b3-ac54fa5bb 3a4c04-4f0e-4d6a-84a7-c2ef0a3f02e3/Dereks%20Site/Shared%20Documents/SharePoint/desktop.ini' -Displaypath SharePoint_ConfigVmset6/SharePoint - 80/Dereks Site/Dereks Site/Shared Documents/SharePoint/desktop.ini' |
This example places the resource sp://titan/0ee296d6-dea5-4f4d-950f-27c06458cad1/57947f70-c2b0-4d76-a8b3-ac54fa5bb4ab/203a4c04-4f0e-4d6a-84a7-c2ef0a3f02e3/Dereks%20Site/Shared%20Documents/SharePoint/desktop.ini under governance for the managed host identified by ca990043-8ffc-4eea-8e11-179a1d3505af. |