Quitar PSDrive (Microsoft.PowerShell.Management)

Quitar-PSDrive

Módulo:

Microsoft.PowerShell.Management

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

Sintaxis

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

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

Descripción

El cmdlet Remove-PSDrive elimina las unidades temporales de PowerShell que se crearon 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 se conecta una unidad externa a la computadora, PowerShell agrega automáticamente un PSDrive al sistema de archivos que representa la nueva unidad. No es necesario reiniciar PowerShell. De manera similar, cuando se desconecta una unidad externa de la computadora, PowerShell elimina automáticamente el PSDrive que representa la unidad extraída.

Ejemplos

Ejemplo 1: eliminar una unidad del sistema de archivos

Este comando elimina una unidad del sistema de archivos temporal llamada smp.

Remove-PSDrive -Name smp

Ejemplo 2: eliminar unidades de red asignadas

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

Get-PSDrive X, S | Remove-PSDrive

Parámetros

-Confirm

Le solicita confirmación antes de ejecutar el cmdlet.

Tipo :

SwitchParameter

Alias:

cf

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Force

Elimina la unidad PowerShell actual.

Tipo :

SwitchParameter

Posición:

Nombrado

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 utiliza exactamente como se escribió. Ningún carácter se interpreta como 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 secuencia 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 eliminarán. 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 PSProvider. Este cmdlet elimina y desconecta todas las unidades asociadas con el proveedor de PowerShell especificado.

Tipo :

String[]

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-Scope

Especifica un alcance para la unidad. Los valores aceptables para este parámetro son: Global, Local y Script, o un número relativo al alcance actual. Número de ámbitos 0 hasta el número de ámbitos. El número de alcance actual es 0 y su padre es 1. Para obtener más información, consulte about_Scopes.

Tipo :

String

Posición:

Nombrado

Valor predeterminado:

Local

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-WhatIf

Muestra lo que sucedería si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo :

SwitchParameter

Alias:

wi

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

PSDriveInfo

Puede canalizar un objeto de unidad, como desde el cmdlet Get-PSDrive, a este cmdlet.

Salidas

Ninguno

Este cmdlet no devuelve ningún resultado.

Notas

PowerShell incluye los siguientes alias para Remove-PSDrive:

• Todas las plataformas:

  rdr

• El cmdlet Remove-PSDrive está diseñado para funcionar con los datos expuestos por cualquier proveedor de PowerShell. Para enumerar los proveedores en su sesión, utilice el cmdlet Get-PSProvider. Para obtener más información, consulte about_Providers.