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.