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


-------------- Example 1 Returns log messages of a specified level --------------
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}
   

-------------- Example 2 Returns all messages of a specified source type with a specified level and higher --------------
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}