Get-StorageDiagnosticInfo

  • Reference
Module:
Storage

Gets Storage diagnostic information.

Syntax

Get-StorageDiagnosticInfo
   -InputObject <CimInstance>
   -DestinationPath <String>
   [-TimeSpan <UInt32>]
   [-ActivityId <String>]
   [-ExcludeOperationalLog]
   [-ExcludeDiagnosticLog]
   [-IncludeLiveDump]
   [-CimSession <CimSession>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]
Get-StorageDiagnosticInfo
   [-StorageSubSystemFriendlyName] <String>
   -DestinationPath <String>
   [-TimeSpan <UInt32>]
   [-ActivityId <String>]
   [-ExcludeOperationalLog]
   [-ExcludeDiagnosticLog]
   [-IncludeLiveDump]
   [-CimSession <CimSession>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]
Get-StorageDiagnosticInfo
   -StorageSubSystemName <String>
   -DestinationPath <String>
   [-TimeSpan <UInt32>]
   [-ActivityId <String>]
   [-ExcludeOperationalLog]
   [-ExcludeDiagnosticLog]
   [-IncludeLiveDump]
   [-CimSession <CimSession>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]
Get-StorageDiagnosticInfo
   -StorageSubSystemUniqueId <String>
   -DestinationPath <String>
   [-TimeSpan <UInt32>]
   [-ActivityId <String>]
   [-ExcludeOperationalLog]
   [-ExcludeDiagnosticLog]
   [-IncludeLiveDump]
   [-CimSession <CimSession>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

The Get-StorageDiagnosticInfo cmdlet gets Storage event logs, trace logs (if present), and live dumps of all nodes in the specified Storage subsystem. Event logs are gathered into one .evtx file per machine, and trace logs are gathered in .etw format. The cmdlet copies this information to path specified by the DestinationPath parameter.

By default, this cmdlet gathers information for the past 24 hours. To specify a different number of hours, use the TimeSpan parameter.

Examples

Example 1: Get all logs and dumps for a cluster subsystem

PS C:\>Get-StorageDiagnosticInfo -StorageSubSystemName "VMMCluster.contoso.corp.microsoft.com" -DestinationPath "\\FileShare1\Debug\"

This command gets all types of logs and dumps for the specified Storage cluster subsystem.

Parameters

-ActivityId

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AsJob

Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

Type:CimSession
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationPath

Type:String
Aliases:Path
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeDiagnosticLog

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeOperationalLog

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeLiveDump

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies the input object that is used in a pipeline command.

Type:CimInstance
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageSubSystemFriendlyName

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StorageSubSystemName

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StorageSubSystemUniqueId

Type:String
Aliases:StorageSubSystemId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeSpan

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Notes

  • When used in Failover Cluster, cmdlets from the Storage module operate on cluster level (all servers in the cluster).