Click or drag to resize

Get-DtLogicalItem

This cmdlet returns the logical items associated with the specified workload. For this cmdlet, the -ServiceHost should be your source server.

Syntax

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

Parameters
-RefItem<LogicalItem>

Specify an object returned from a previous Get-DtLogicalItem call.

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

<CommonParameters>

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 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.

$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