Get-ClusterLog
Creates a log file for all nodes, or a specific a node, in a failover cluster.
Syntax
Get-ClusterLog
[[-Node] <StringCollection>]
[-Destination <String>]
[-TimeSpan <UInt32>]
[-UseLocalTime]
[-SkipClusterState]
[-Health]
[-InputObject <PSObject>]
[-Cluster <String>]
[<CommonParameters>] Description
The Get-ClusterLog cmdlet creates a log file for all nodes, or a specific a node, in a failover cluster.
When creating a log file for the cluster, you can specify the timespan that you want logged information for in addition to providing a destination for the created logs.
Note: This cmdlet cannot be run remotely without Credential Security Service Provider (CredSSP) authentication on the server computer.
Examples
Example 1: Create a log file for the local cluster
PS C:\> Get-ClusterLog
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 9/4/2008 3:53 PM 2211301 Cluster.log
-a--- 9/4/2008 3:53 PM 1261025 Cluster.logThis command creates a log file for the local cluster in the cluster reports folder (C:\Windows\Cluster\Reports) on each node of the cluster.
Example 2: Create log files for each node and save them locally
PS C:\> Get-ClusterLog -Destination .
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 9/4/2008 3:55 PM 2211301 node1_cluster.log
-a--- 9/4/2008 3:55 PM 1261025 node2_cluster.logThis command creates a log file for each node of the local cluster, and copies all logs to the local folder.
Example 3: Create a log file for the local cluster for previous five minutes
PS C:\> Get-ClusterLog -TimeSpan 5
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 9/4/2008 3:58 PM 128299 Cluster.log
-a--- 9/4/2008 4:01 PM 104181 Cluster.logThis command creates a log file for the local cluster in the cluster reports folder (C:\Windows\Cluster\Reports) on each node of the cluster. The log covers the last 5 minutes.
Parameters
-Cluster
Specifies the name of the cluster on which to run this cmdlet.
If the input for this parameter is . or it is omitted, then the cmdlet runs on the local cluster.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Destination
Specifies the location to which to copy one or more cluster logs.
To copy to the current folder, use . for this parameter input.
Default location is C:\Windows\Cluster\Reports.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Health
Indicates that the cmdlet also logs the health information of the cluster.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Specifies the cluster from which to generate cluster logs.
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Node
Specifies the name of the cluster node for which to generate the cluster log.
| Type: | StringCollection |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkipClusterState
Indicates that the cmdlet does not add additional cluster state information to the cluster logs.
| Type: | SwitchParameter |
| Aliases: | scs |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeSpan
Specifies the time span in minutes for which to generate the cluster log.
| Type: | UInt32 |
| Aliases: | Span |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseLocalTime
Specifies that the time stamp for each cluster log entry uses local time. By default, the timestamp uses Greenwich Mean Time (GMT).
| Type: | SwitchParameter |
| Aliases: | lt |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
Microsoft.FailoverClusters.PowerShell.Cluster