Get-StorageDiagnosticInfo
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-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
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AsJob
Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-CimSession
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.
Parameter properties
| Type: | CimSession |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DestinationPath
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Path |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ExcludeDiagnosticLog
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.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ExcludeOperationalLog
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.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-IncludeLiveDump
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.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-InputObject
Specifies the input object that is used in a pipeline command.
Parameter properties
| Type: | CimInstance |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
ByStorageSubSystem
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-StorageSubSystemFriendlyName
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
ByStorageSubSystemFriendlyName
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-StorageSubSystemName
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
ByStorageSubSystemName
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-StorageSubSystemUniqueId
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | StorageSubSystemId |
Parameter sets
ByStorageSubSystemUniqueId
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ThrottleLimit
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.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-TimeSpan
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.
Parameter properties
| Type: | UInt32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Notes
- When used in Failover Cluster, cmdlets from the Storage module operate on cluster level (all servers in the cluster).