Remove-PSDrive
Elimina unidades temporales de PowerShell y desconecta unidades de red asignadas.
Syntax
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 Remove-PSDrive
cmdlet elimina las unidades temporales de PowerShell que se crearon mediante el New-PSDrive
cmdlet .
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 Persist
parámetro 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. De forma similar, 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 elimina una unidad del sistema de archivos temporal denominada "smp".
Remove-PSDrive -Name smp
Ejemplo 2: Eliminación de unidades de red asignadas
Este comando usa Remove-PSDrive
para desconectar las unidades de red asignadas X: y S.
Get-PSDrive X, S | Remove-PSDrive
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 |
-Force
Quita la unidad actual de PowerShell.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LiteralName
Especifica el nombre de la unidad.
El valor de LiteralName se usa exactamente como se escribió. Ninguno de los caracteres se interpreta como caracteres comodín. Si el nombre incluye caracteres de escape, escríbalo entre comillas sencillas ('). Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica los nombres de las unidades de disco que se van a eliminar. No escriba un signo de dos puntos (:) después del nombre de la unidad.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-PSProvider
Especifica una matriz de objetos PSProvider . Este cmdlet quita y desconecta todas las unidades asociadas al proveedor de PowerShell especificado.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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. Los ámbitos número 0 hasta 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, consulte about_Scopes.
Type: | String |
Position: | Named |
Default value: | Local |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro solo es válido cuando hay una transacción en curso. Para más información, consulte about_Transactions.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
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
Puede canalizar un objeto de unidad, como uno del Get-PSDrive
cmdlet, al Remove-PSDrive
cmdlet .
Salidas
None
Este cmdlet no genera resultados de ningún tipo.
Notas
- El
Remove-PSDrive
cmdlet está diseñado para trabajar con los datos expuestos por cualquier proveedor de PowerShell. Para enumerar los proveedores de la sesión, use elGet-PSProvider
cmdlet . Para obtener más información, consulte about_Providers.