NAME
Get-DcsLogMessage
SYNOPSIS
Returns Event Log messages for all servers in the connection.
SYNTAX
Get-DcsLogMessage [ -Level <String[]> ] [ -MatchLevel] [ -SourceType <String[]> ] [ -Source <Object> ] [ -Count <Int32> ] [ -StartTime <DateTime> ] [ -EndTime <DateTime> ] [ -Server <String[]> ] [ -Connection <String> ] [ -PipelineVariable <String> ]
DESCRIPTION
Returns Event Log messages for all servers in the connection. Filtering parameters may be specified to narrow the scope of the data returned. If no parameters are specified, all log messages for all servers in the default connection will be returned.
PARAMETERS
- -Level<String[]>
- Name or ID that identifies one or more message types. Possible level parameters (in order from highest to lowest) include: "Diagnostic", "Error", "Warning", "Info", and "Trace". If specified, only data for the designated level and all higher levels will be returned. For instance, if the parameter value is "Warning" then all messages with "Diagnostic", "Error", and "Warning" will be returned. If the MatchLevel parmeter is specified, then only the levels that are specified in the Level parameter will be returned.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -MatchLevel<SwitchParameter>
- This parameter allows specific level types to be returned. When specified, only the values entered for the Level parameter will be returned. For instance, if the values entered for the Level parameter is "Warning", "Error" then only the Warning and Error messages will be returned.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -SourceType<String[]>
- Name or ID that identifies one or more SAN component types. If specified, only data for the designated source types will be returned. Valid values include: "General", "Diskpools", "Mirrors", "Monitors", "Paths", "Physical disks", "Ports", "Replications", "Rollbacks", "Security", "Snapshots", "Hosts", "DataCoreServers", "Tasks", "DiskSources", "VirtualDisks", and "Support".
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -Source<Object>
- The ID of any object identifying a particular source. (See SourceType for valid types.)
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: true (ByValue)
- Accept wildcard characters: false
-
- -Count<Int32>
- The Count parameter can limit the number of log messages returned. If specified, the number of messages returned will not exceed the parameter value.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -StartTime<DateTime>
- This parameter specifies the start of the list of returned log messages. Only messages with the same date and time or later will be returned. A time frame can be specified by using both StartTime and EndTime. One way to provide the StartTime parameter would be by piping a variable created by invoking New-Object with the TypeName parameter of DateTime with the correct arguments (see the Help for New-Object, Get-Date). The StartTime parameter can also be provided in a string with the date and time. An example of the format to use is "04/06/2011 02:51:00 PM" which represents April 6, 2011 at 2:51 PM. This value must be in quotes.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -EndTime<DateTime>
- This parameter specifies the end of the list of returned log messages. Only messages with the same date and time or earlier will be returned. A time frame can be specified by using both StartTime and EndTime. One way to provide the EndTime parameter would be by piping a variable created by invoking New-Object with the TypeName parameter of DateTime with the correct arguments (see the Help for New-Object, Get-Date). The EndTime parameter can also be provided in a string with the date and time. An example of the format to use is "04/06/2011 02:51:00 PM" which represents April 6, 2011 at 2:51 PM. This value must be in quotes.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -Server<String[]>
- Computer name or ID of one or more servers in a group. The computer name must be unique or the name must be fully qualified. Only data for the specified servers will be returned.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -Connection<String>
- Alias of the connection to the server group. If not specified, the default connection is used.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -PipelineVariable<String>
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
INPUTS
Object : Any object that identifies the source.
OUTPUTS
LogMessageData : Object identifying the Event Log message.
NOTES
Also see Get-DcsAlert, Clear-DcsAlert, Add-DcsLogMessage
EXAMPLES
Get-DcsLogMessage -Level Warning -MatchLevel
The MatchLevel parameter is used to returns only log messages with a Level of "Warning".
Id | : | DataCore.Executive.LogMessageId |
TimeStamp | : | 8/16/2011 10:10:41 AM |
MachineName | : | SSV1 |
Level | : | Warning |
Visibility | : | Customer |
HighPriority | : | False |
NeedsAcknowledge | : | False |
MessageText | : | Failure status of {0} changed to {1}. |
MessageData | : | {Virtual disk 3 @ 8/16/2011 10:10:20 AM on SSV1, No disk access} |
UserId | : | |
UserName | : | |
Caller | : | LogicalDisk.UpdateCoreLogicalDiskData |
Sources | : | {LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000032, 54893a865cc4412d83b43ba09179996d} |
Id | : | DataCore.Executive.LogMessageId |
TimeStamp | : | 8/16/2011 10:08:11 AM |
MachineName | : | SSV1 |
Level | : | Warning |
Visibility | : | Customer |
HighPriority | : | False |
NeedsAcknowledge | : | False |
MessageText | : | Failure status of {0} changed to {1}. |
MessageData | : | {Virtual disk 4 on SSV1, No disk access} |
UserId | : | |
UserName | : | |
Caller | : | LogicalDisk.UpdateCoreLogicalDiskData |
Sources | : | {LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000030, a18dea18ed93428a8951afa75ef6792f} |
Id | : | DataCore.Executive.LogMessageId |
TimeStamp | : | 8/16/2011 10:08:08 AM |
MachineName | : | SSV1 |
Level | : | Warning |
Visibility | : | Customer |
HighPriority | : | False |
NeedsAcknowledge | : | False |
MessageText | : | Failure status of {0} changed to {1}. |
MessageData | : | {Virtual disk 3 on SSV1, No disk access} |
UserId | : | |
UserName | : | |
Caller | : | LogicalDisk.UpdateCoreLogicalDiskData |
Sources | : | {LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-0000002F, 635134ab2cad4b5d81af73ae5f09bd6f} |
Id | : | DataCore.Executive.LogMessageId |
TimeStamp | : | 8/16/2011 10:07:34 AM |
MachineName | : | SSV1 |
Level | : | Warning |
Visibility | : | Customer |
HighPriority | : | False |
NeedsAcknowledge | : | False |
MessageText | : | Failure status of {0} changed to {1}. |
MessageData | : | {Virtual disk 2 on SSV2, No disk access} |
UserId | : | |
UserName | : | |
Caller | : | LogicalDisk.UpdateCoreLogicalDiskData |
Sources | : | {LD:C553D471-3527-47EC-9326-D53E04204F2B_V.{315f03ec-bdf5-11e0-9dc3-00155d11e923}-0000002B, a6c21da23ec84baa80ab6a5c8c8c605c} |
Id | : | DataCore.Executive.LogMessageId |
TimeStamp | : | 8/16/2011 10:07:34 AM |
MachineName | : | SSV1 |
Level | : | Warning |
Visibility | : | Customer |
HighPriority | : | False |
NeedsAcknowledge | : | False |
MessageText | : | Failure status of {0} changed to {1}. |
MessageData | : | {Virtual disk 2 on SSV1, No disk access} |
UserId | : | |
UserName | : | |
Caller | : | LogicalDisk.UpdateCoreLogicalDiskData |
Sources | : | {LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-0000002E, a6c21da23ec84baa80ab6a5c8c8c605c} |
Get-DcsLogMessage -Level Warning -SourceType "VirtualDisks"
Returns all log messages with a source type of "VirtualDisks" that are a level of Warning or higher (Warning, Error, or Diagnostic). In this case there are two messages that satisfy the parameters.
Id | : | DataCore.Executive.LogMessageId |
TimeStamp | : | 8/15/2011 5:14:14 PM |
MachineName | : | SSV1 |
Level | : | Warning |
Visibility | : | Customer |
HighPriority | : | True |
NeedsAcknowledge | : | False |
MessageText | : | Failed to create paths between the port(s) on Host3 and the port(s) on SSV2. |
The possible reason | : | No free connection is available between the chosen initiator and target ports. |
MessageData | : | |
UserId | : | |
UserName | : | |
Caller | : | StorageServices.ServeVirtualDiskToNexus |
Sources | : | {0dc5596489cb4d8ba0346f80eb47ad46} |
Id | : | DataCore.Executive.LogMessageId |
TimeStamp | : | 8/15/2011 5:13:12 PM |
MachineName | : | SSV1 |
Level | : | Warning |
Visibility | : | Customer |
HighPriority | : | False |
NeedsAcknowledge | : | False |
MessageText | : | Failure status of {0} changed to {1}. |
MessageData | : | {Virtual disk 1 on SSV1, No disk access} |
UserId | : | |
UserName | : | |
Caller | : | LogicalDisk.UpdateCoreLogicalDiskData |
Sources | : | {LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-0000002D, 0dc5596489cb4d8ba0346f80eb47ad46} |