Compartilhar via


Remove-PSDrive

Remove uma unidade do Windows PowerShell do seu local.

Sintaxe

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

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

Descrição

O cmdlet Remove-PSDrive excluir as unidades do Windows PowerShell criadas com New-PSDrive.

Remove-PSDrive não pode excluir unidades do Windows ou unidades de rede mapeadas criadas com outros métodos nem a unidade de trabalho atual.

Parâmetros

-Force

Permite o cmdlet remova a unidade atual do Windows PowerShell.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-LiteralName <string[]>

Especifica o nome da unidade do Windows PowerShell a ser removida.

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

Necessário?

true

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-Name <string[]>

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

Necessário?

true

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-PSProvider <string[]>

Remove todas as unidades do Windows PowerShell associadas ao provedor do Windows PowerShell especificado.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-Scope <string>

Aceita um índice que identifica o escopo do qual a unidade está sendo removida.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-UseTransaction

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

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.Management.Automation.PSDriveInfo

É possível enviar um objeto de unidade para Remove-PSDrive.

Saídas

Nenhum

Este cmdlet não retorna nenhuma saída.

Observações

O cmdlet Remove-PSDrive foi desenvolvido para funcionar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite "Get-PSProvider". Para obter mais informações, consulte about_Providers.

Exemplo 1

C:\PS>remove-psdrive -name smp

Descrição
-----------
Esse comando remove uma unidade do Windows PowerShell chamada "smp".





Consulte também

Conceitos

about_Providers
Get-PSDrive
New-PSDrive