Get-DtDiagnostics

This cmdlet collects configuration data for use when reporting problems to technical support. Because the diagnostics are gathering several pieces of information, potentially across the network to the machine where you are running the cmdlet, it may take several minutes to complete the information gathering and sending the resulting zip file to the cmdlet machine. For this cmdlet, the -ServiceHost could be your source or target server.

Syntax

Get-DtDiagnostics [-OutputDirectory] <String> [-ServiceHost] <Server> [<CommonParameters>]

Parameters

-OutputDirectory<String>

Specify the full location and file name with a .zip extension, on the machine where you are running the Get-DtDiagnostics cmdlet, to store the resulting zip file containing the diagnostics information.

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. Then diagnostics are collected for the server and stored at the root of the C: drive in the file called AlphaDiagnostics.zip. The connections for the server object are then closed.

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

Get-DtDiagnostics -ServiceHost $DtServerObjectAlpha "C:\AlphaDiagnostics.zip"

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha