Cmdlets > Get-DtLogicalItem

Get-DtLogicalItem

Returns workload logical items

Syntax

Get-DtLogicalItem [-ServiceHost] <Server> [-WorkloadId] <Guid> [-RefItem <LogicalIteget-gm>] [<CommonParameters>]

Detailed Description

This cmdlet returns the logical items associated with the specified workload.

Parameters

Name	Type	Description	Required	Pipeline Input
Service Host	Server	Specify the server object returned from the New-DtServer cmdlet. For this cmdlet, the -ServiceHost should be your source server.	true	false
WorkloadId	Guid	Specify the workload GUID returned from the New-DtWorkload cmdlet using the workload type name parameter.	true	false
RefItem	LogicalItems	Specify an object returned from a previous Get-DtLogicalItem call.	false	false

Outputs

LogicalItems [ ]

Examples

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

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

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

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha

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 full sever 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. The connections for the server object are then closed.