Compartir a través de

Remove-PSDrive

Módulo:
Microsoft.PowerShell.Management Module

Elimina las unidades temporales de PowerShell y desconecta las unidades de red asignadas.

Sintaxis

Name (valor predeterminado) 

Remove-PSDrive
    [-Name] <String[]>
    [-PSProvider <String[]>]
    [-Scope <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

LiteralName 

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 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: Eliminar unidades de red asignadas

Este comando usa Remove-PSDrive para desconectar las unidades de red X: y S: asignadas.

Get-PSDrive X, S | Remove-PSDrive

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

-Force

Elimina la unidad actual de PowerShell.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
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

-LiteralName

Especifica el nombre de la unidad.

El valor de LiteralName se usa exactamente como se ha escrito. Ninguno de los caracteres se interpreta 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.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

LiteralName
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

-Name

Especifica los nombres de las unidades de disco que se van a eliminar. No escriba dos puntos (:) después del nombre de la unidad.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

Name
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

-PSProvider

Especifica una matriz de objetos de PSProvider. Este cmdlet quita y desconecta todas las unidades asociadas al proveedor de PowerShell especificado.

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:True
Valor de los argumentos restantes: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 es 0 al 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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:Local
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:True
Valor de los argumentos restantes: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, consulte about_Transactions.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:usetx

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

PSDriveInfo

Puede canalizar un objeto de unidad, como uno del cmdlet Get-PSDrive, al cmdlet Remove-PSDrive.

Salidas

None

Este cmdlet no genera resultados de ningún tipo.

Notas

  • 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 cmdlet Get-PSProvider. Para obtener más información, consulte about_Providers.