New-PublicFolder

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2009-05-12

Use o cmdlet New-PublicFolder para criar uma nova pasta pública com o nome especificado.

Sintaxe

New-PublicFolder -Name <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Path <PublicFolderIdParameter>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet New-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.

Parâmetros

Parâmetro Necessário Tipo Descrição

Name

Necessário

System.String

O parâmetro Name especifica o nome para a pasta pública.

Confirm

Opcional

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.

Path

Opcional

Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter

O parâmetro Path especifica o local da pasta na hierarquia de pastas; por exemplo, \Legal\Cases.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

O parâmetro Server especifica o servidor no qual criar a pasta pública.

Se um servidor não for especificado, o comando verificará se o servidor local é um servidor de caixa de correio do Microsoft Exchange Server 2007 com um armazenamento de pasta pública. Se for, a pasta pública será criada localmente. Se não for, o Exchange localizará o servidor de caixa de correio do Exchange 2007 mais próximo (por custo do site) que tenha um armazenamento de pasta pública no qual criar a pasta pública.

WhatIf

Opcional

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

O código a seguir fornece exemplos de como usar o comando New-PublicFolder:

  • O exemplo um cria uma nova pasta pública denominada MyPublicFolder na raiz da árvore de pasta pública no servidor local do servidor de caixa de correio mais próximo com um armazenamento de pasta pública.

  • O exemplo dois cria uma nova pasta pública denominada MyPublicFolder sob as pasta existentes \Legal\Cases. O caminho para a nova pasta será \Legal\Cases\MyPublicFolder em Server2.

New-PublicFolder -Name MyPublicFolder 
New-PublicFolder -Name MyPublicFolder -Path \Legal\Cases -Server Server2

O parâmetro Server oferece suporte ao recurso para aceitar um pipeline para seu argumento e tipo forte. Isso habilita o gerenciamento em massa.