Remove-PSDrive

  • Referencia
Módulo:
Microsoft.PowerShell.Management

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

Syntax

Remove-PSDrive
      [-Name] <String[]>
      [-PSProvider <String[]>]
      [-Scope <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSDrive
      [-LiteralName] <String[]>
      [-PSProvider <String[]>]
      [-Scope <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<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 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: Eliminación de unidades de red asignadas

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

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 de PowerShell actual.

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 con tipo. 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.

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 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, Localy Scripto un número relativo al ámbito actual. El número 0 de ámbitos se realiza a través del 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

-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

PSDriveInfo

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

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

PowerShell incluye los siguientes alias para Remove-PSDrive:

  • Todas las plataformas:

    • rdr

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