Export-Cau Report

Exports one or more Updating Run reports into an HTML or CSV-formatted document.

Syntax

Export-CauReport
      [-InputReport] <CauReport[]>
      [-Format] <OutputType>
      [-Path] <String>
      [-PassThru]
      [-Force]
      [-TimeZone <TimeZoneInfo>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Export-CauReport cmdlet exports one or more Updating Run reports into an HTML or CSV-formatted document. Each Run report summarizes both the node-level and cluster-level summary status for the Updating Run.

Pipe one or more reports from the Get-CauReport cmdlet with the Detailed parameter, and control the content in the report by specifying appropriate parameters for the Get-CauReport cmdlet. For example, the Last parameter specifies the most recent Updating Run.

Examples

Example 1: Get a detailed version of the last CAU report for the specified cluster

PS C:\> Get-CauReport -ClusterName "Contoso-FC1" -Last -Detailed | Export-CauReport -Format HTML -Path "C:\temp\contoso-fc1_last.html" -TimeZone ([system.timezoneinfo]::Utc)

This command gets a detailed version of the last CAU report for the cluster named Contoso-FC1, then exports that report in HTML format to the path C:\temp\contoso-fc1_last.html. The timestamps in the report are formatted in the Coordinated Universal Time (UTC) zone.

Required Parameters

-Format

Specifies the format of the output report. The acceptable values for this parameter are: CSV or HTML.

Type: OutputType
Parameter Sets: Csv, Html
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputReport

Specifies an array of CAU report objects, such as generated from a call to Get-CauReport with the Detailed parameter.

Type: CauReport[]
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Path

Specifies the local or complete path of the file to save the exported report.

Type: String
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Aliases: cf
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Force

Forces the command to run without asking for user confirmation.

Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TimeZone

Specifies the formatting of the report timestamps to match the specified time zone.

Type: TimeZoneInfo
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Aliases: wi
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Inputs

Microsoft.ClusterAwareUpdating.CauReport

Outputs

Microsoft.ClusterAwareUpdating.CauReport