Remove-PSDrive

  • Referência
Módulo:
Microsoft.PowerShell.Management

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

Sintaxe

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

Description

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

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

Remove-PSDrive não é possível 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 é usado Remove-PSDrive para desconectar as X: unidades de rede mapeadas e S: mapeadas.

Get-PSDrive X, S | Remove-PSDrive

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Remove a unidade atual do PowerShell.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

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

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-PSProvider

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

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Scope

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

Tipo:String
Cargo:Named
Valor padrão:Local
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-UseTransaction

Inclui o comando na transação ativa. Este parâmetro é válido somente quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.

Tipo:SwitchParameter
Aliases:usetx
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSDriveInfo

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

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

O Windows PowerShell inclui os seguintes aliases para Remove-PSDrive:

  • rdr

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