Compartir a través de

Remove-Variable

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

Description

El cmdlet Remove-Variable elimina una variable y su valor del ámbito en el que se define, como la sesión actual. No puede usar este cmdlet para eliminar variables que se establecen como constantes o las que pertenecen al sistema.

Ejemplos

Ejemplo 1: Quitar una variable

Remove-Variable Smp

Este comando elimina la variable $Smp.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Exclude

Especifica una matriz de elementos que este cmdlet omite de la operación. El valor de este parámetro califica el parámetro Name. Escriba un elemento o patrón de nombre, como "s*". Se permiten caracteres comodín.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Force

Indica que el cmdlet quita una variable aunque sea de solo lectura. Incluso con el parámetro Force, el cmdlet no puede quitar una constante.

Tipo:SwitchParameter
Posición:Named
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 Name. Escriba un elemento de nombre o patrón, como s*. Se permiten caracteres comodín.

Tipo:String[]
Posición:Named
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 va a quitar. El nombre del parámetro (Nombre) es opcional. Se permiten caracteres comodín

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-Scope

Obtiene solo las variables del ámbito especificado. Los valores aceptables para este parámetro son:

  • Global
  • Local
  • Guión
  • Número relativo al ámbito actual (de 0 al número de ámbitos, donde 0 es el ámbito actual y 1 es su elemento primario).

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
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

None

Este cmdlet no devuelve ninguna salida.

Notas

PowerShell incluye los siguientes alias para Remove-Variable:

  • Todas las plataformas:

    • rv

  • Los cambios afectan solo al ámbito actual, como una sesión. Para eliminar una variable de todas las sesiones, agregue un comando Remove-Variable al perfil de PowerShell.