Compartir a través de

about_Throw

Descripción breve

Describe la palabra clave Throw, que genera un error de terminación.

Descripción larga

La palabra clave Throw provoca un error de terminación. Puede utilizar la palabra clave Throw para detener el procesamiento de un comando, una función o un script.

Por ejemplo, puede utilizar la palabra clave Throw en el bloque de script de una instrucción If para responder a una condición o en el bloque Catch de una instrucción Try-Catch-Finally. También puede utilizar la palabra clave Throw en una declaración de parámetro para hacer que un parámetro de función sea obligatorio.

La palabra clave Throw puede producir cualquier objeto, como una cadena de mensaje de usuario o el objeto que causó el error.

Sintaxis

La sintaxis de la palabra clave Throw es la siguiente:

throw [<expression>]

La expresión de la sintaxis Throw es opcional. Cuando la instrucción Throw no aparece en un bloque Catch y no incluye una expresión, genera un error ScriptHalted.

C:\PS> throw

Exception: ScriptHalted

Si la palabra clave Throw se utiliza en un bloque Catch sin una expresión, vuelve a producir la RuntimeException actual. Para obtener más información, consulte about_Try_Catch_Finally.

Inicio de una cadena

La expresión opcional de una instrucción Throw puede ser una cadena, como se muestra en el ejemplo siguiente:

C:\PS> throw "This is an error."

Exception: This is an error.

Lanzar otros objetos

La expresión también puede ser un objeto que produce el objeto que representa el proceso de PowerShell, como se muestra en el ejemplo siguiente:

C:\PS> throw (get-process Pwsh)

Exception: System.Diagnostics.Process (pwsh) System.Diagnostics.Process (pwsh) System.Diagnostics.Process (pwsh)

Puede utilizar la propiedad TargetObject del objeto ErrorRecord en la variable automática $error para examinar el error.

C:\PS> $error[0].targetobject

 NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
    125   174.44     229.57      23.61    1548   2 pwsh
     63    44.07      81.95       1.75    1732   2 pwsh
     63    43.32      77.65       1.48    9092   2 pwsh

También puede producir un objeto ErrorRecord o una excepción de .NET. En el ejemplo siguiente se usa la palabra clave Throw para iniciar un objeto System.FormatException.

C:\PS> $formatError = new-object system.formatexception

C:\PS> throw $formatError

OperationStopped: One of the identified items was in an invalid format.

El error resultante

La palabra clave Throw puede generar un objeto ErrorRecord. La propiedad Exception del objeto ErrorRecord contiene un objeto RuntimeException. El resto del objeto ErrorRecord y el objeto RuntimeException varían según el objeto que produce la palabra clave Throw.

El objeto RunTimeException se encapsula en un objeto ErrorRecord y el objeto ErrorRecord se guarda automáticamente en la $Error variable automática.

Uso de Throw para crear un parámetro obligatorio

A diferencia de las versiones anteriores de PowerShell, no use la palabra clave Throw para la validación de parámetros. Consulte about_Functions_Advanced_Parameters para conocer la manera correcta.

Consulte también

  • Last updated on