Remove-Variable (Microsoft.PowerShell.Utility)

Remove-Variable

Módulo:

Microsoft.PowerShell.Utility

Elimina una variable y su valor.

Sintaxis

Remove-Variable
      [-Name] <String[]>
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Force]
      [-Scope <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descripción

El cmdlet Remove-Variable elimina una variable y su valor del ámbito en el que está definida, como la sesión actual. No puede utilizar este cmdlet para eliminar variables establecidas como constantes o aquellas que son propiedad del sistema.

Ejemplos

Ejemplo 1: eliminar una variable

Remove-Variable Smp

Este comando elimina la variable $Smp.

Parámetros

-Confirm

Le solicita confirmación antes de ejecutar el cmdlet.

Tipo :

SwitchParameter

Alias:

cf

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Exclude

Especifica una serie de elementos que este cmdlet omite de la operación. El valor de este parámetro califica el parámetro Nombre. Introduzca un elemento de nombre o patrón, como "s*". Se permiten comodines.

Tipo :

String[]

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

True

-Force

Indica que el cmdlet elimina una variable incluso si es de solo lectura. Incluso utilizando el parámetro Force, el cmdlet no puede eliminar una constante.

Tipo :

SwitchParameter

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Include

Especifica una matriz de elementos que este cmdlet elimina en la operación. El valor de este parámetro califica el parámetro Nombre. Introduzca un elemento de nombre o patrón, como s*. Se permiten comodines.

Tipo :

String[]

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

True

-Name

Especifica el nombre de la variable que se eliminará. El nombre del parámetro (Nombre) es opcional. Se permiten comodines

Tipo :

String[]

Posición:

0

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

True

-Scope

Obtiene sólo las variables en el ámbito especificado. Los valores aceptables para este parámetro son:

• Global
• Local
• Guion
• Un número relativo al ámbito actual (de 0 al número de ámbitos, donde 0 es el ámbito actual y 1 es su padre)

Local es el valor predeterminado. Para obtener más información, consulte about_Scopes.

Tipo :

String

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-WhatIf

Muestra lo que sucedería si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo :

SwitchParameter

Alias:

wi

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

PSVariable

Puede canalizar un objeto variable a este cmdlet.

Salidas

Ninguno

Este cmdlet no devuelve ningún resultado.

Notas

PowerShell incluye los siguientes alias para Remove-Variable:

• Todas las plataformas:

  rv

• Los cambios afectan sólo al ámbito actual, como una sesión. Para eliminar una variable de todas las sesiones, agregue un comando Eliminar variable a su perfil de PowerShell.