Write-Error

Sintassi

Write-Error
     [-Message] <string>
     [-Category <ErrorCategory>]
     [-ErrorId <string>]
     [-TargetObject <Object>]
     [-RecommendedAction <string>]
     [-CategoryActivity <string>]
     [-CategoryReason <string>]
     [-CategoryTargetName <string>]
     [-CategoryTargetType <string>]
     [<CommonParameters>]

Write-Error
     [-Exception] <Exception>
     [-Message <string>]
     [-Category <ErrorCategory>]
     [-ErrorId <string>]
     [-TargetObject <Object>]
     [-RecommendedAction <string>]
     [-CategoryActivity <string>]
     [-CategoryReason <string>]
     [-CategoryTargetName <string>]
     [-CategoryTargetType <string>]
     [<CommonParameters>]

Write-Error
     [-ErrorRecord] <ErrorRecord>
     [-RecommendedAction <string>]
     [-CategoryActivity <string>]
     [-CategoryReason <string>]
     [-CategoryTargetName <string>]
     [-CategoryTargetType <string>]
     [<CommonParameters>]

Descrizione

Il Write-Error cmdlet dichiara un errore non irreversibile. Per impostazione predefinita, gli errori vengono inviati nel flusso di errori al programma host per essere visualizzati insieme all'output.

Per scrivere un errore non irreversibile, immettere una stringa di messaggio di errore, un oggetto ErrorRecord o un oggetto Exception . Usare gli altri parametri di per popolare il record di Write-Error errore.

Gli errori non irreversibili scrivono un errore nel flusso di errore, ma non arrestano l'elaborazione dei comandi. Se un errore non irreversibile viene dichiarato per un elemento di una raccolta di elementi di input, il comando continua a elaborare gli altri elementi della raccolta.

Per dichiarare un errore di terminazione, usare la Throw parola chiave . Per altre informazioni, vedere about_Throw.

Esempio

Esempio 1: Scrivere un errore per l'oggetto RegistryKey

Get-ChildItem | ForEach-Object {
    if ($_.GetType().ToString() -eq "Microsoft.Win32.RegistryKey")
    {
        Write-Error "Invalid object" -ErrorId B1 -TargetObject $_
    }
    else
    {
        $_
    }
}

Questo comando dichiara un errore non irreversibile quando il Get-ChildItem cmdlet restituisce un Microsoft.Win32.RegistryKey oggetto, ad esempio gli oggetti nelle HKLM: unità o HKCU: del provider del Registro di sistema di PowerShell.

Esempio 2: Scrivere un messaggio di errore nella console

Write-Error "Access denied."

Questo comando dichiara un errore non irreversibile e scrive un errore "Access denied". Il comando usa il parametro Message per specificare il messaggio, ma omette il nome del parametro Message facoltativo.

Esempio 3: Scrivere un errore nella console e specificare la categoria

Write-Error -Message "Error: Too many input values." -Category InvalidArgument

Questo comando dichiara un errore non irreversibile e specifica una categoria di errore.

Esempio 4: Scrivere un errore usando un oggetto Exception

$E = [System.Exception]@{Source="Get-ParameterNames.ps1";HelpLink="https://go.microsoft.com/fwlink/?LinkID=113425"}
Write-Error -Exception $E -Message "Files not found. The $Files location doesn't contain any XML files."

Questo comando usa un oggetto Exception per dichiarare un errore non irreversibile.

Il primo comando usa una tabella hash per creare l'oggetto System.Exception . Salva l'oggetto eccezione nella $E variabile . È possibile usare una tabella hash per creare qualsiasi oggetto di un tipo che contiene un costruttore null.

Il secondo comando usa il Write-Error cmdlet per dichiarare un errore non irreversibile. Il valore del parametro Exception è l'oggetto Exception nella $E variabile .

Parametri

-Category

-CategoryActivity

-CategoryReason

-CategoryTargetName

-CategoryTargetType

-ErrorId

-ErrorRecord

-Exception

-Message

-RecommendedAction

-TargetObject

Input

String

È possibile inviare tramite pipe una stringa contenente un messaggio di errore a questo cmdlet.

Output

None

Questo cmdlet non restituisce output. Scrive solo nel flusso dei messaggi di errore.

Note

Write-Error non modifica il valore della $? variabile automatica, pertanto non segnala una condizione di errore irreversibile. Per segnalare un errore irreversibile, usare il metodo $PSCmdlet.WriteError().

Collegamenti correlati

• about_Automatic_Variables
• about_Output_Streams
• about_Redirection
• Write-Debug
• Write-Host
• Write-Output
• Write-Progress
• Write-Verbose
• Write-Warning