Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Get-StorageDiagnosticInfo

Brian Lich|Last Updated: 3/8/2017

SYNOPSIS

Gets Storage diagnostic information.

SYNTAX

ByStorageSubSystem

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

ByStorageSubSystemFriendlyName

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

ByStorageSubSystemName

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

ByStorageSubSystemUniqueId

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.

PARAMETERS

-ActivityId

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
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
Parameter Sets: (All)
Aliases: 

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

-CimSession

Type: CimSession
Parameter Sets: (All)
Aliases: 

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

-DestinationPath

Type: String
Parameter Sets: (All)
Aliases: Path

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

-ExcludeDiagnosticLog

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

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

-ExcludeOperationalLog

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

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

-IncludeLiveDump

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

Required: False
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
Parameter Sets: ByStorageSubSystem
Aliases: 

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-StorageSubSystemFriendlyName

Type: String
Parameter Sets: ByStorageSubSystemFriendlyName
Aliases: 

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

-StorageSubSystemName

Type: String
Parameter Sets: ByStorageSubSystemName
Aliases: 

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

-StorageSubSystemUniqueId

Type: String
Parameter Sets: ByStorageSubSystemUniqueId
Aliases: StorageSubSystemId

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

-ThrottleLimit

Type: Int32
Parameter Sets: (All)
Aliases: 

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

-TimeSpan

Type: UInt32
Parameter Sets: (All)
Aliases: 

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

© 2017 Microsoft