Compartir a través de

Remove-Variable

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Elimina una variable y su valor.

Syntax

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 se puede usar este cmdlet para eliminar las variables que se definen como constantes o que son propiedad del sistema.

Ejemplos

Ejemplo 1: Quitar una variable

PS C:\> Remove-Variable Smp

Este comando elimina la variable $Smp.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 los caracteres comodín.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 o patrón de nombre, como s*. Se permiten los caracteres comodín.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica el nombre de la variable que se va a quitar. El nombre del parámetro (Name) es opcional.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Scope

Obtiene solo las variables en el ámbito especificado. Los valores permitidos para este parámetro son los siguientes:

  • Global
  • Local
  • Script
  • 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 más información, consulte about_Scopes.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSVariable

Puede canalizar un objeto de variable a Remove-Variable.

Salidas

None

Este cmdlet no genera resultados de ningún tipo.

Notas

  • Los cambios afectan únicamente al ámbito actual, a una sesión, por ejemplo. Para eliminar una variable de todas las sesiones, agregue un comando Remove-Variable al perfil de Windows PowerShell.

    También puede hacer referencia a Remove-Variable por su alias integrado, rv. Para más información, vea la página about_Aliases.