New-ManagedFolder

 

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

Tópico modificado em: 2010-11-29

Use o cmdlet New-ManagedFolder para criar novas pastas gerenciadas para o MRM (Gerenciamento de Registros de Mensagens). Uma pasta gerenciada é uma pasta em uma caixa de correio de usuário à qual o MRM foi aplicado. Veja os tipos de pastas gerenciadas a seguir:

  • As pastas padrão gerenciadas (tais como a Caixa de entrada) são exibidas, por padrão, na caixa de correio de um usuário do Microsoft Office Outlook 2007. Essas pastas exigem apenas uma licença de acesso para cliente (CAL) do Exchange Server Standard.

  • As pastas personalizadas gerenciadas são criadas pelos administradores do Exchange especificamente para MRM. As pastas personalizadas gerenciadas são um recurso premium do MRM. Cada caixa de correio que tem pastas personalizadas gerenciadas exige uma CAL do Exchange Server Enterprise.

A retenção e o registro no diário de mensagens em pastas gerenciadas são controlados pelas configurações de conteúdo gerenciado que são aplicadas às pastas gerenciadas.

Sintaxe

New-ManagedFolder -Name <String> -FolderName <String> [-BaseFolderOnly <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedFolderName <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-StorageQuota <Unlimited>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

New-ManagedFolder -Name <String> -DefaultFolderType <Nullable> [-BaseFolderOnly <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LocalizedComment <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Use o cmdlet New-ManagedFolder para criar uma nova pasta gerenciada no serviço de diretório do Active Directory. Em seguida, para usar a nova pasta gerenciada para gerenciamento de registros de mensagens:

  1. Aplique configurações de conteúdo gerenciado à pasta.

  2. Vincule a pasta a uma diretiva de caixa de correio de pasta gerenciada.

  3. Vincule a diretiva de caixa de correio à caixa de correio de um usuário.

  4. Execute o assistente de pasta gerenciada, que coloca a nova pasta gerenciada na caixa de correio do usuário com as configurações que você especificou.

  5. Para obter mais informações sobre as etapas de implementação do gerenciamento de registro de mensagens no Microsoft Exchange Server 2007, consulte Implantando o gerenciamento de registros de mensagens.

Por padrão, as pastas personalizadas gerenciadas são criadas com esse cmdlet. No entanto, você também pode criar cópias adicionais de pastas padrão gerenciadas, usando o parâmetro DefaultFolderType para especificar que tipo de pasta padrão deve ser criado (por exemplo, uma pasta Caixa de Entrada adicional). Ao criar várias cópias de uma pasta padrão gerenciada, você pode atribuir configurações de conteúdo diferentes para cada uma delas. Por exemplo, você pode ter duas pastas Caixa de Entrada, uma chamada InboxSixMonths e outra InboxOneYear. Depois, você poderia atribuir um tempo de retenção de seis meses para a primeira pasta e outro de um ano para a segunda, usando o cmdlet New-ManagedContentSettings (ou usando o assistente de Novas Configurações de Conteúdo Gerenciado no Console de Gerenciamento do Exchange). Você deve atribuir um nome exclusivo (usando o parâmetro Name) a cada uma das pastas padrão gerenciadas que criar. Contudo, os usuários visualizarão sempre o nome da pasta padrão inalterado. No exemplo, se for atribuída aos usuários uma pasta InboxSixMonths ou uma pasta InboxOneYear, a Caixa de Entrada que eles verão em sua caixa de correio terá o nome Caixa de Entrada. Embora os nomes de pasta visualizados pelos usuários em suas caixas de correio possam ser atribuídos novamente para pastas padrão gerenciadas (usando o comando Set-ManagedFolder e o parâmetro FolderName), os nomes atribuídos às pastas padrão gerenciadas que os usuários vêem, não podem ser alterados.

Antes de começar

Para executar o cmdlet New-ManagedFolder, você deve usar uma conta à qual esteja delegado o seguinte:

  • Função Administrador da Organização do Exchange

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.

Esse comando não aceita entrada em pipeline.

Parâmetros

Parâmetro Necessário Tipo Descrição

DefaultFolderType

Necessário

System.Nullable

O parâmetro DefaultFolderType especifica que tipo de pasta padrão será criada (por exemplo, uma pasta Caixa de Entrada adicional). Se tiver várias cópias de uma pasta padrão, você poderá atribuir configurações de conteúdo diferentes para cada uma delas. Por exemplo, é possível ter duas pastas Caixa de Entrada, uma na qual o conteúdo é retido por um mês e outra na qual o conteúdo é retido por um ano. Você deve atribuir um nome exclusivo (usando o parâmetro Name) para cada uma das várias pastas padrão gerenciadas.

Se não for inserido um valor para o parâmetro DefaultFolderType, uma pasta personalizada gerenciada será criada. Os tipos de pasta que você pode especificar são:

  • Calendar

  • Contacts

  • DeletedItems

  • Drafts

  • Inbox

  • JunkEmail

  • Journal

  • Notes

  • Outbox

  • SentItems

  • Tasks

  • All

  • ManagedCustomFolder

  • RssSubscriptions

  • SyncIssues

  • ConversationHistory

FolderName

Necessário

System.String

O parâmetro FolderName especifica o nome da pasta como ele aparecerá nas caixas de correio dos usuários. Você não pode definir o valor FolderName para pastas padrão gerenciadas. Essa cadeia de caracteres pode ter no máximo 255 caracteres.

Dica

O parâmetroFolderName não deve ser confundido com o parâmetroName.

Name

Necessário

System.String

O parâmetro Name especifica um nome exclusivo para a pasta. Esse valor é usado pelo administrador como um identificador para a pasta. Ele não aparece nas caixas de correio dos usuários. Essa cadeia de caracteres pode ter no máximo 65 caracteres.

Dica

O parâmetroName não deve ser confundido com o parâmetroFolderName.

BaseFolderOnly

Opcional

System.Boolean

O parâmetro BaseFolderOnly é usado para impedir que o assistente de pasta gerenciada aplique a diretiva de caixa de correio ao conteúdo das subpastas da pasta gerenciada.

Comment

Opcional

System.String

O parâmetro Comment especifica o comentário padrão do administrador a ser exibido com a pasta no Microsoft Outlook 2007 e no Outlook Web Access. Essa cadeia de caracteres pode ter no máximo 255 caracteres.

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

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que recupera dados do Active Directory, inclua o parâmetro DomainController no comando.

LocalizedComment

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro LocalizedComment especifica comentários localizados do administrador e seus idiomas. Quando a configuração de idioma do Outlook 2007 corresponder a um idioma especificado para esse valor de parâmetro, comentários localizados serão exibidos em vez dos comentários padrão. Os comentários devem estar no formato ISOLanguageCode:Comment (por exemplo, -LocalizedComment EN-US:"Esse é um comentário localizado em inglês dos Estados Unidos").

LocalizedFolderName

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro LocalizedFolderName especifica nomes de pastas localizados e seus idiomas. Nomes de pastas localizados são exibidos em vez do nome de pasta padrão, quando a configuração de idioma do Outlook 2007 corresponder a um idioma especificado para esse valor de parâmetro. Os comentários devem estar no formato ISOLanguageCode:Comment (por exemplo, -LocalizedFolderName EN-US:"Esse é um nome de pasta localizado em inglês dos Estados Unidos").

MustDisplayCommentEnabled

Opcional

System.Boolean

Se o parâmetro MustDisplayCommentEnabled estiver presente e definido como $true, ele definirá um sinalizador usado pelo Outlook 2007 para impedir que os usuários minimizem um comentário de pasta (visível no Outlook 2007 e no Outlook Web Access). Se o parâmetro não estiver presente ou estiver definido como $false, os usuários poderão minimizar o comentário.

StorageQuota

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro StorageQuota especifica o limite de tamanho de armazenamento para a pasta de caixa de correio. Quando o tamanho da pasta exceder esse limite, nenhum outro item poderá ser adicionado. Os tamanhos das caixas de correio podem ser especificados em quilobytes (KB) ou megabytes (MB) (por exemplo, como 100 KB ou 5 MB)

TemplateInstance

Opcional

System.Management.Automation.PSObject

Quando um objeto existente for fornecido ao parâmetro TemplateInstance, o comando usará a configuração desse objeto para criar uma duplicata exata do objeto em um servidor local ou de destino.

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

No primeiro exemplo, o comando New-ManagedFolder é usado para criar uma nova pasta gerenciada com capacidade máxima de 1 MB.

No segundo exemplo, o comando New-ManagedFolder é usado para criar uma nova pasta gerenciada com um nome de pasta padrão e comentário em inglês, nomes de pastas localizados em espanhol e francês e comentário localizado em espanhol.

No terceiro exemplo, uma nova instância da pasta padrão Caixa de Entrada é criada.

New-ManagedFolder -Name NewFolder -FolderName "New Folder" -StorageQuota "1 MB"
New-ManagedFolder -Name MyFolder -FolderName "My Folder" -LocalizedFolderName Spanish:"Mi Carpeta", French:"Mon Dossier" -Comment "My comment" -LocalizedComment Spanish:"Mi comentario", French:"Mon annotation"
New-ManagedFolder -Name AnotherInbox -DefaultFolderType Inbox