Set-DtLogicalItemSelection

This cmdlet adds or removes a logical items for the specified workload for the specified server. Adding or removing logical items will add or remove physical rules depending on the workload type. For this cmdlet, the -ServiceHost should be your source server.

Syntax

Set-DtLogicalItemSelection [-LogicalPath] <String> [-Unselect] <SwitchParameter> [-WorkloadId] <Guid> [-ServiceHost] <Server> [<CommonParameters>]

Parameters

-LogicalPath<String>

Specify the path of an item returned from Get-DtLogicalItem.

Required?	true
Position?	3
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Unselect<SwitchParameter>

Specify this option if you want to remove the logical item.

Required?	false
Position?	named
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WorkloadId<Guid>

Specify the workload GUID returned from the New-DtWorkload cmdlet using the workload type name parameter.

Required?	true
Position?	2
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ServiceHost<Server>

Specify the server object returned from the New-DtServer cmdlet.

Required?	true
Position?	1
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters.

Examples

------------------EXAMPLE------------------

A server object is created for the server alpha using the domain\administrator and password credentials. It assigns the server object to the variable called DtServerObjectAlpha. The script then creates a workload on the server for a files and folders job, returning a global unique ID for the workload, and assigns that ID to the variable DtWorkloadGuid. The logical items associated with the workload type and the server are then stored in the variable DtLogicalItems. Finally, the first logical item in DtLogicalItems is added to the workload. The connections for the server object are then closed.

$DtServerObjectAlpha= New-DtServer -Name alpha -UserName domain\administrator -Password password

$DtWorkloadGuid = New-DtWorkload -ServiceHost $DtServerObjectAlpha -WorkloadTypeName FilesAndFolders

$DtLogicalItems = Get-DtLogicalItem -ServiceHost $DtServerObjectAlpha -WorkloadId $DtWorkloadGUID

Set-DtLogicalItemSelection -ServiceHost $DtServerObjectAlpha -WorkloadId $DtWorkloadGuid -LogicalPath $DtLogicalItem[0].Path

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha