Get-Storage Diagnostic Info

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-StorageDiagnostics -StorageSubSystemName "VMMCluster.contoso.corp.microsoft.com" -DestinationPath "\\FileShare1\Debug\"

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

Required Parameters

-DestinationPath
Type: String
Aliases: Path
Position: Named
Default value: None
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
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-StorageSubSystemFriendlyName
Type: String
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-StorageSubSystemName
Type: String
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-StorageSubSystemUniqueId
Type: String
Aliases: StorageSubSystemId
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Optional Parameters

-ActivityId
Type: String
Position: Named
Default value: None
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
Accept pipeline input: False
Accept wildcard characters: False
-CimSession
Type: CimSession
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExcludeDiagnosticLog
Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExcludeOperationalLog
Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IncludeLiveDump
Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ThrottleLimit
Type: Int32
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TimeSpan
Type: UInt32
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False