Remove-PSDrive
Quita una unidad de Windows PowerShell de su ubicación.
Sintaxis
Remove-PSDrive [-LiteralName] <string[]> [-Force] [-PSProvider <string[]>] [-Scope <string>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Remove-PSDrive [-Name] <string[]> [-Force] [-PSProvider <string[]>] [-Scope <string>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Descripción
El cmdlet Remove-PSDrive elimina unidades de Windows PowerShell que se crearon utilizando New-PSDrive.
Remove-PSDrive no puede eliminar las unidades de Windows ni las unidades de red asignadas creadas con otros métodos ni tampoco puede eliminar la unidad de trabajo actual.
Parámetros
-Force
Permite al cmdlet quitar la unidad actual de Windows PowerShell.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-LiteralName <string[]>
Especifica el nombre de la unidad de Windows PowerShell.
El valor de LiteralName se usa literalmente como se escribe. Ningún carácter se interpretará como un carácter comodín. Si el nombre incluye caracteres de escape, debe escribirlo entre comillas simples ('). Las comillas simples indican a Windows PowerShell que no debe interpretar caracteres como secuencias de escape.
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-Name <string[]>
Especifica los nombres de las unidades de Windows PowerShell que se van a quitar. No escriba un signo de dos puntos (:) después del nombre de la unidad.
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-PSProvider <string[]>
Quita todas las unidades de Windows PowerShell asociadas al proveedor especificado de Windows PowerShell.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-Scope <string>
Acepta un índice que identifica el ámbito del que se quita la unidad.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByPropertyName) |
¿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 |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro solo es válido cuando hay una transacción en curso. Para obtener más información, vea about_Transactions.
¿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.PSDriveInfo Puede canalizar un objeto de unidad a Remove-PSDrive. |
Salidas |
Ninguno Este cmdlet no devuelve resultados. |
Notas
El cmdlet Remove-PSDrive está diseñado de modo que funcione con los datos expuestos por cualquier proveedor. Para mostrar los proveedores que están disponibles en la sesión, escriba "Get-PSProvider". Para obtener más información, vea about_Providers.
Ejemplo 1
C:\PS>remove-psdrive -name smp
Descripción
-----------
Este comando quita una unidad de Windows PowerShell denominada "smp".