Write-Error

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>]

De Write-Error-cmdlet declareert een niet-afsluitfout. Standaard worden fouten in de foutstroom verzonden naar het hostprogramma dat moet worden weergegeven, samen met uitvoer.

Als u een niet-afsluitfout wilt schrijven, voert u een tekenreeks voor een foutbericht, een ErrorRecord-object of een Uitzonderings--object in. Gebruik de andere parameters van Write-Error om de foutrecord te vullen.

Niet-afsluitfouten schrijven een fout naar de foutstroom, maar ze stoppen de verwerking van opdrachten niet. Als een niet-afsluitfout wordt gedeclareerd voor één item in een verzameling invoeritems, blijft de opdracht de andere items in de verzameling verwerken.

Als u een afsluitfout wilt declareren, gebruikt u het trefwoord throw. Zie about_Throwvoor meer informatie.

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

Met deze opdracht wordt een niet-afsluitfout declareren wanneer de Get-ChildItem cmdlet een Microsoft.Win32.RegistryKey-object retourneert, zoals de objecten in de HKLM: of HKCU: stations van de PowerShell-registerprovider.

Write-Error "Access denied."

Met deze opdracht wordt een niet-afsluitfout gede declareert en wordt de fout 'Toegang geweigerd' geschreven. Met de opdracht wordt de parameter Message gebruikt om het bericht op te geven, maar wordt de optionele parameternaam Message weggelaten.

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

Met deze opdracht wordt een niet-afsluitfout declareren en wordt een foutcategorie opgegeven.

$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."

Deze opdracht maakt gebruik van een Uitzondering object om een niet-afsluitfout te declareren.

De eerste opdracht maakt gebruik van een hash-tabel om het System.Exception--object te maken. Hiermee wordt het uitzonderingsobject opgeslagen in de $E variabele. U kunt een hash-tabel gebruiken om elk object van een type te maken dat een null-constructor heeft.

De tweede opdracht maakt gebruik van de Write-Error cmdlet om een niet-afsluitfout te declareren. De waarde van de parameter Exception is het object Exception in de variabele $E.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een tekenreeks met een foutbericht doorsturen naar deze cmdlet.

Deze cmdlet retourneert geen uitvoer. Het schrijft alleen naar de stroom van het foutbericht.

Write-Error wijzigt de waarde van de $? automatische variabele niet, waardoor er geen afsluitfoutvoorwaarde wordt opgegeven. Als u een afsluitfout wilt signaleren, gebruikt u de methode $PSCmdlet.WriteError().