Remove-PublicFolder
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2010-02-16
Use o cmdlet Remove-PublicFolder para remover uma pasta pública existente.
Sintaxe
Remove-PublicFolder -Identity <PublicFolderIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Recurse <SwitchParameter>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Para executar o cmdlet Remove-PublicFolder, você deve usar a conta à qual esteja delegada a seguinte função:
- Função de Administrador de Pasta Pública do Exchange e grupo Administradores local no servidor de destino
Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.
Aviso
O cmdlet Remove-PublicFolder removerá os dados da pasta pública de todos os servidores da sua empresa. Se você desejar remover somente os dados de um servidor, utilize o comando Set-PublicFolder –replicas. Para obter mais informações, consulte Set-PublicFolder.
Parâmetros
Parâmetro | Necessário | Tipo | Descrição |
---|---|---|---|
Identity |
Necessário |
Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter |
Utilize o parâmetro Identity para especificar a GUID ou o nome da pasta pública que representa uma pasta pública específica. Você pode também incluir o caminho utilizando o formato TopLevelPublicFolder\PublicFolder. Você pode omitir o rótulo do parâmetro Identity para que somente o nome da pasta pública ou a GUID seja fornecido. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
O parâmetro DomainController especifica o controlador de domínio a ser usado para gravar essa alteração de configuração no Active Directory. Use o nome de domínio totalmente qualificado (FQDN) do controlador de domínio a ser usado. |
Recurse |
Opcional |
System.Management.Automation.SwitchParameter |
Quando especificado, o parâmetro Recurse especifica que todas as subpastas da pasta especificada devem ser removidas. Se o parâmetro Recurse não for especificado e a pasta pública possuir subpastas, o comando não será executado e retornará uma mensagem de erro. |
Server |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
O parâmetro Server especifica a identidade do servidor do qual a pasta pública será removida. |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf. |
Tipos de entrada
Tipos de retorno
Erros
Erro | Descrição |
---|---|
|
Exceções
Exceções | Descrição |
---|---|
|
Exemplo
Este exemplo exclui a pasta pública chamada My Public Folder da árvore \Test\Directory.
Remove-PublicFolder -Identity "\Test\Directory\My Public Folder"
Todos os parâmetros do comando Remove-PublicFolder aceitam entrada de pipeline.