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".