Skip to content

Commit 64d40e4

Browse files
Merge pull request MicrosoftDocs#3337 from mdowst/WindowsUpdateLog_3320
Quality: quality improvements on Get-WindowsUpdateLog.md
2 parents 460289c + dce9d8f commit 64d40e4

File tree

1 file changed

+48
-28
lines changed

1 file changed

+48
-28
lines changed

docset/winserver2022-ps/windowsupdate/Get-WindowsUpdateLog.md

Lines changed: 48 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -11,28 +11,37 @@ title: Get-WindowsUpdateLog
1111
# Get-WindowsUpdateLog
1212

1313
## SYNOPSIS
14-
Merges Windows Update .etl files into a single log file.
14+
15+
Merges Windows Update `.etl` files into a single log file.
1516

1617
## SYNTAX
1718

1819
```
19-
Get-WindowsUpdateLog [[-ETLPath] <String[]>] [[-LogPath] <String>] [-ProcessingType <String>] [-ForceFlush]
20-
[-WhatIf] [-Confirm] [<CommonParameters>]
20+
Get-WindowsUpdateLog [[-ETLPath] <String[]>] [[-LogPath] <String>]
21+
[-ProcessingType <String>] [-ForceFlush] [-WhatIf] [-Confirm] [<CommonParameters>]
2122
```
2223

2324
## DESCRIPTION
24-
The **Get-WindowsUpdateLog** cmdlet merges and converts Windows Update .etl files into a single readable WindowsUpdate.log file.
25-
Windows Update Agent uses Event Tracing for Windows (ETW) to generate diagnostic logs.
26-
Windows Update no longer directly produces a WindowsUpdate.log file.
27-
Instead, it produces .etl files that are not immediately readable as written.
2825

29-
For Windows 10 versions prior to 1709 (OS Build 16299), this cmdlet requires access to a Microsoft symbol server, and log decoding must be run from a Windows 10 version earlier than 1709. Logs from Windows 10, version 1709 onward do not require a Microsoft symbol server, and need to be decoded from Windows 10, versions 1709 or higher.
26+
The `Get-WindowsUpdateLog` cmdlet merges and converts Windows Update `.etl` files into a single
27+
readable `WindowsUpdate.log` file. Windows Update Agent uses Event Tracing for Windows (ETW) to
28+
generate diagnostic logs. Windows Update no longer directly produces a `WindowsUpdate.log` file.
29+
Instead, it produces `.etl` files that are not immediately readable as written.
30+
31+
For Windows 10 versions prior to 1709 (OS Build 16299), this cmdlet requires access to a Microsoft
32+
symbol server, and log decoding must be run from a Windows 10 version earlier than 1709. Logs from
33+
Windows 10, version 1709 onward do not require a Microsoft symbol server, and need to be decoded
34+
from Windows 10, versions 1709 or higher.
3035

3136
## EXAMPLES
3237

3338
### Example 1: Merge and convert Windows Update trace files
39+
40+
```powershell
41+
Get-WindowsUpdateLog
3442
```
35-
PS C:\> Get-WindowsUpdateLog
43+
44+
```Output
3645
Converting C:\Windows\logs\WindowsUpdate into C:\Users\Admin\Desktop\WindowsUpdate.log
3746
3847
@@ -70,11 +79,13 @@ The command completed successfully.
7079
WindowsUpdate.log written to C:\Users\admin\Desktop\WindowsUpdate.log
7180
```
7281

73-
This command merges and converts Windows Update trace files (.etl files) into a single readable WindowsUpdate.log file.
82+
This command merges and converts Windows Update trace files (`.etl` files) into a single readable
83+
`WindowsUpdate.log` file.
7484

7585
## PARAMETERS
7686

7787
### -Confirm
88+
7889
Prompts you for confirmation before running the cmdlet.
7990

8091
```yaml
@@ -90,13 +101,14 @@ Accept wildcard characters: False
90101
```
91102
92103
### -ETLPath
93-
Specifies an array of paths of Windows Update .etl files to convert into WindowsUpdate.log.
94-
The default value for this parameter is the Windows Update trace file directory for the current device.
104+
105+
Specifies an array of paths of Windows Update `.etl` files to convert into `WindowsUpdate.log`. The
106+
default value for this parameter is the Windows Update trace file directory for the current device.
95107
The acceptable values for this parameter are:
96108

97-
- The full path of a directory that contains one or more .etl files.
98-
- The full path of a single .etl file.
99-
- A comma-separated list of full paths of .etl files.
109+
- The full path of a directory that contains one or more `.etl` files.
110+
- The full path of a single `.etl` file.
111+
- A comma-separated list of full paths of `.etl` files.
100112

101113
```yaml
102114
Type: String[]
@@ -111,10 +123,11 @@ Accept wildcard characters: False
111123
```
112124

113125
### -ForceFlush
114-
Indicates that this cmdlet forces the Windows Update Agent on the current device to flush all of its traces to .etl files.
115-
This process stops the Update Orchestrator and Windows Update services.
116-
Running this cmdlet with this parameter requires administrative credentials.
117-
You can start Windows PowerShell with administrative credentials by using the Run as administrator command.
126+
127+
Indicates that this cmdlet forces the Windows Update Agent on the current device to flush all of its
128+
traces to `.etl` files. This process stops the Update Orchestrator and Windows Update services.
129+
Running this cmdlet with this parameter requires administrative credentials. You can start Windows
130+
PowerShell with administrative credentials by using the Run as administrator command.
118131

119132
```yaml
120133
Type: SwitchParameter
@@ -129,8 +142,9 @@ Accept wildcard characters: False
129142
```
130143

131144
### -LogPath
132-
Specifies the full path to which **Get-WindowsUpdateLog** writes WindowsUpdate.log.
133-
The default value is WindowsUpdate.log in the Desktop folder of the current user.
145+
146+
Specifies the full path to which `Get-WindowsUpdateLog` writes `WindowsUpdate.log`.
147+
The default value is `WindowsUpdate.log` in the Desktop folder of the current user.
134148

135149
```yaml
136150
Type: String
@@ -145,14 +159,15 @@ Accept wildcard characters: False
145159
```
146160

147161
### -ProcessingType
148-
Specifies the file type that **Get-WindowsUpdateLog** uses for temporary files that are created during intermediate processing.
149-
The acceptable values for this parameter are:
150162

151-
- CSV (comma-separated values)
152-
- XML
163+
Specifies the file type that `Get-WindowsUpdateLog` uses for temporary files that are created
164+
during intermediate processing. The acceptable values for this parameter are:
153165

154-
By default, the value is XML.
155-
The temporary files are in $env:TEMP\WindowsUpdateLog.
166+
- `CSV` (comma-separated values)
167+
- `XML`
168+
169+
By default, the value is `XML`.
170+
The temporary files are in `$env:TEMP\WindowsUpdateLog`.
156171

157172
```yaml
158173
Type: String
@@ -168,6 +183,7 @@ Accept wildcard characters: False
168183
```
169184

170185
### -WhatIf
186+
171187
Shows what would happen if the cmdlet runs.
172188
The cmdlet is not run.
173189

@@ -184,7 +200,11 @@ Accept wildcard characters: False
184200
```
185201

186202
### CommonParameters
187-
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
203+
204+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
205+
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
206+
-WarningAction, and -WarningVariable. For more information, see
207+
[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
188208

189209
## INPUTS
190210

0 commit comments

Comments
 (0)