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 Remove-Variable cmdlet 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

Remove-Variable Smp

Este comando elimina la $Smp variable .

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

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 de nombre o patrón, como s*. Se permiten los caracteres comodín.

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

-Name

Especifica el nombre de la variable que se va a quitar. El nombre del parámetro (Name) es opcional. Se permiten caracteres comodín

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

-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 obtener 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 variable a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

PowerShell incluye los siguientes alias para Remove-Variable:

  • Todas las plataformas:

    • rv

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