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 |
None 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".
See Also