Remove-Variable
Elimina una variable y su valor.
Sintaxis
Default (valor predeterminado)
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
PS C:\> Remove-Variable Smp
Este comando elimina la variable $Smp.
Parámetros
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Exclude
Especifica una matriz de elementos que este cmdlet omite de la operación. El valor de este parámetro condiciona el parámetro Name. Escriba un elemento o patrón de nombre, como "s*". Se permiten los caracteres comodín.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Include
Especifica una matriz de elementos que este cmdlet elimina en la operación. El valor de este parámetro condiciona el parámetro Name. Escriba un elemento de nombre o patrón, como s*. Se permiten los caracteres comodín.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Especifica el nombre de la variable que se va a quitar. El nombre del parámetro (Nombre) es opcional.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Scope
Obtiene solo las variables del ámbito especificado. Los valores aceptables para este parámetro son:
- 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.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
PSVariable
Puede canalizar un objeto variable a Remove-Variable.
Salidas
None
Este cmdlet no genera resultados de ningún tipo.
Notas
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 Windows PowerShell.
También puede hacer referencia a Remove-Variable por su alias integrado, rv. Para obtener más información, consulte about_Aliases.