Remove-PSDrive
Elimina las unidades temporales de PowerShell y desconecta las unidades de red asignadas.
Sintaxis
Remove-PSDrive
[-Name] <String[]>
[-PSProvider <String[]>]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Remove-PSDrive
[-LiteralName] <String[]>
[-PSProvider <String[]>]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Description
El cmdlet Remove-PSDrive
elimina las unidades temporales de PowerShell creadas mediante el cmdlet New-PSDrive
.
A partir de Windows PowerShell 3.0, Remove-PSDrive
también desconecta las unidades de red asignadas, incluidas, entre otras, las unidades creadas mediante el parámetro Persist de de New-PSDrive
.
Remove-PSDrive
no puede eliminar unidades físicas o lógicas de Windows.
A partir de Windows PowerShell 3.0, cuando una unidad externa está conectada al equipo, PowerShell agrega automáticamente un PSDrive al sistema de archivos que representa la nueva unidad. No es necesario reiniciar PowerShell. Del mismo modo, cuando se desconecta una unidad externa del equipo, PowerShell elimina automáticamente el PSDrive que representa la unidad eliminada.
Ejemplos
Ejemplo 1: Quitar una unidad del sistema de archivos
Este comando quita una unidad temporal del sistema de archivos denominada smp
.
Remove-PSDrive -Name smp
Ejemplo 2: Eliminación de unidades de red asignadas
Este comando usa Remove-PSDrive
para desconectar el X:
y S:
unidades de red asignadas.
Get-PSDrive X, S | Remove-PSDrive
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 |
-Force
Quita la unidad de PowerShell actual.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-LiteralName
Especifica el nombre de la unidad.
El valor de LiteralName se usa exactamente como se escribe. No se interpreta ningún carácter como caracteres comodín.
Si el nombre incluye caracteres de escape, escríbalo entre comillas simples ('
). Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.
Tipo: | String[] |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Name
Especifica los nombres de las unidades que se van a quitar. No escriba dos puntos (:
) después del nombre de la unidad.
Tipo: | String[] |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | True |
-PSProvider
Especifica una matriz de objetos de PSProvider. Este cmdlet quita y desconecta todas las unidades asociadas al proveedor de PowerShell especificado.
Tipo: | String[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Scope
Especifica un ámbito para la unidad. Los valores aceptables para este parámetro son: Global
, Local
y Script
, o un número relativo al ámbito actual. El número de ámbitos 0
el número de ámbitos. El número de ámbito actual es 0
y su elemento primario es 1
. Para obtener más información, vea about_Scopes.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | Local |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro solo es válido cuando una transacción está en curso. Para obtener más información, vea about_Transactions.
Tipo: | SwitchParameter |
Alias: | usetx |
Posición: | Named |
Valor predeterminado: | False |
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
Puede canalizar un objeto de unidad, como desde el cmdlet Get-PSDrive
, a este cmdlet.
Salidas
None
Este cmdlet no devuelve ninguna salida.
Notas
Windows PowerShell incluye los siguientes alias para Remove-PSDrive
:
rdr
El cmdlet
Remove-PSDrive
está diseñado para trabajar con los datos expuestos por cualquier proveedor de PowerShell. Para enumerar los proveedores de la sesión, use el cmdletGet-PSProvider
. Para obtener más información, vea about_Providers.