Elimina una variable y su valor.

Sintaxis

Remove-Variable [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Scope <string>] [-Confirm] [-WhatIf] [<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. Este cmdlet no se puede usar para eliminar variables que se han definido como constantes o que son propiedad del sistema.

Parámetros

-Exclude <string[]>

Omite los elementos especificados. El valor de este parámetro califica el parámetro Name. Escriba un patrón o un elemento del nombre, como "s*". Se permite el uso de caracteres comodín.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Force

Permite al cmdlet quitar una variable, incluso si es de solo lectura. Aunque use el parámetro Force, el cmdlet no puede quitar una constante.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Include <string[]>

Elimina únicamente los elementos especificados. El valor de este parámetro califica el parámetro Name. Escriba un patrón o un elemento del nombre, como "s*". Se permite el uso de caracteres comodín.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Name <string[]>

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

¿Requerido?

true

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

true (ByPropertyName)

¿Aceptar caracteres comodín?

false

-Scope <string>

Especifica el ámbito en el que es válido este alias. Los valores válidos son "Global", "Local", "Script" o el número correspondiente al ámbito actual (entre 0 y el número de ámbitos, donde 0 es el ámbito actual y 1 su ámbito principal). "Local" es el valor predeterminado. Para obtener más información, vea about_Scopes.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Confirm

Solicita confirmación antes de ejecutar el comando.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

System.Management.Automation.PSVariable

Puede canalizar un objeto de variable a Remove-Variable.

Salidas

Ninguno

Este cmdlet no devuelve resultados.

Notas

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

También puede referirse a RemoveVariable mediante su alias integrado, "rv". Para obtener más información, vea about_Aliases.

Ejemplo 1

C:\PS>remove-variable Smp

Descripción
-----------
Este comando elimina la variable $Smp.






Vea también




Tabla de contenido