Compartilhar via

Remove-PSDrive

Módulo:
Microsoft.PowerShell.Management Module

Exclui unidades temporárias do PowerShell e desconecta unidades de rede mapeadas.

Sintaxe

Name (Padrão) 

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

LiteralName 

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

Description

O cmdlet Remove-PSDrive exclui unidades temporárias do PowerShell que foram criadas usando o cmdlet New-PSDrive.

A partir do Windows PowerShell 3.0, Remove-PSDrive também desconecta unidades de rede mapeadas, incluindo unidades, mas não limitadas a, criadas usando o parâmetro Persist de New-PSDrive.

Remove-PSDrive não pode excluir unidades físicas ou lógicas do Windows.

A partir do Windows PowerShell 3.0, quando uma unidade externa é conectada ao computador, o PowerShell adiciona automaticamente um PSDrive ao sistema de arquivos que representa a nova unidade. Você não precisa reiniciar o PowerShell. Da mesma forma, quando uma unidade externa é desconectada do computador, o PowerShell exclui automaticamente o PSDrive que representa a unidade removida.

Exemplos

Exemplo 1: remover uma unidade do sistema de arquivos

Esse comando remove uma unidade temporária do sistema de arquivos chamada smp.

Remove-PSDrive -Name smp

Exemplo 2: remover unidades de rede mapeadas

Esse comando usa Remove-PSDrive para desconectar as unidades de rede mapeadas X: e S:.

Get-PSDrive X, S | Remove-PSDrive

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Force

Remove a unidade atual do PowerShell.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LiteralName

Especifica o nome da unidade.

O valor de LiteralName é usado exatamente como digitado. Nenhum caractere é interpretado como caractere curinga. Se o nome incluir caracteres de escape, coloque-o entre aspas simples ('). Aspas simples instruem o PowerShell a não interpretar nenhum caractere como sequências de escape.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

LiteralName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

Especifica os nomes das unidades a serem removidas. Não digite dois-pontos (:) após o nome da unidade.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

Name
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-PSProvider

Especifica uma matriz de objetos PSProvider . Esse cmdlet remove e desconecta todas as unidades associadas ao provedor do PowerShell especificado.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Scope

Especifica um escopo para a unidade. Os valores aceitáveis para esse parâmetro são: Global, Locale Scriptou um número relativo ao escopo atual. O número de escopos 0 por meio do número de escopos. O número de escopo atual é 0 e seu pai é 1. Para obter mais informações, consulte about_Scopes.

Propriedades do parâmetro

Tipo:String
Valor padrão:Local
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSDriveInfo

Você pode redirecionar um objeto de unidade, como do cmdlet Get-PSDrive, para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

O PowerShell inclui os seguintes aliases para Remove-PSDrive:

  • Todas as plataformas:

    • rdr

  • O cmdlet Remove-PSDrive foi projetado para funcionar com os dados expostos por qualquer provedor do PowerShell. Para listar os provedores em sua sessão, use o cmdlet Get-PSProvider. Para obter mais informações, consulte about_Providers.