Get-WindowsUpdateLog

S'applique à: Windows 10, Windows Server Technical Preview

Get-WindowsUpdateLog

Merges Windows Update .etl files into a single log file.

Syntaxe

Parameter Set: Default
Get-WindowsUpdateLog [[-ETLPath] <String[]> ] [[-LogPath] <String> ] [[-SymbolServer] <String> ] [-ForceFlush] [-InformationAction <ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <String> ] [-ProcessingType <String> {CSV | XML} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Description détaillée

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

This cmdlet requires access to a Microsoft symbol server.

Paramètres

-ETLPath<String[]>

Specifies an array of paths of Windows Update .etl files to convert into WindowsUpdate.log. The default value for this parameter is the Windows Update trace file directory for the current device. Les valeurs acceptables pour ce paramètre sont les suivantes : 

-- The full path of a directory that contains one or more .etl files.
-- The full path of a single .etl file.
-- A comma-separated list of full paths of .etl files.

Alias

PsPath

Requis ?

false

Position ?

1

Valeur par défaut

none

Accepter l'entrée de pipeline ?

true(ByValue,ByPropertyName)

Accepter les caractères génériques ?

false

-ForceFlush

Indicates that this cmdlet forces the Windows Update Agent on the current device to flush all of its traces to .etl files. This process stops the Update Orchestrator and Windows Update services. Running this cmdlet with this parameter requires administrative credentials. You can start Windows PowerShell with administrative credentials by using the Run as administrator command.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-InformationAction<ActionPreference>

Specifies how this cmdlet responds to an information event. Les valeurs acceptables pour ce paramètre sont les suivantes : 

-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend

Alias

infa

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-InformationVariable<String>

Specifies a variable in which to store an information event message.

Alias

iv

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-LogPath<String>

Specifies the full path to which Get-WindowsUpdateLog writes WindowsUpdate.log. The default value is WindowsUpdate.log in the Desktop folder of the current user.

Alias

none

Requis ?

false

Position ?

2

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-ProcessingType<String>

Specifies the file type that Get-WindowsUpdateLog uses for temporary files that are created during intermediate processing. Les valeurs acceptables pour ce paramètre sont les suivantes : 

-- CSV (comma-separated values)
-- XML

By default, the value is CSV. The temporary files are in $env:TEMP\WindowsUpdateLog.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-SymbolServer<String>

Specifies the URL of Microsoft Symbol Server. By default, this value is the Microsoft public symbol server.

Alias

none

Requis ?

false

Position ?

3

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Confirm

Vous invite à confirmer l'exécution de l'applet de commande.

Requis ?

false

Position ?

named

Valeur par défaut

false

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-WhatIf

Indique ce qui se produit en cas d'exécution de l'applet de commande. L'applet de commande n'est pas exécutée.

Requis ?

false

Position ?

named

Valeur par défaut

false

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez  . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.

Sorties

Le type de sortie correspond au type des objets que l'applet de commande émet.

Exemples

Example 1: Merge and convert Windows Update trace files

This command merges and converts Windows Update trace files (.etl files) into a single readable WindowsUpdate.log file.

PS C:\> Get-WindowsUpdateLog

Rubriques connexes

Windows Update Cmdlets