New-ManagedFolder

Módulo:

ExchangePowerShell

Aplica-se a:

Exchange Server 2010

Esse cmdlet só está disponível no Exchange Server 2010.

Use o cmdlet New-ManagedFolder para criar um objeto de pasta gerenciado para o gerenciamento de registros de mensagens (MRM).

Esse comando não aceita entrada em pipeline.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

New-ManagedFolder
   [-Name] <String>
   -DefaultFolderType <DefaultManagedFolderType>
   [-BaseFolderOnly <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LocalizedComment <MultiValuedProperty>]
   [-MustDisplayCommentEnabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

New-ManagedFolder
   [-Name] <String>
   -FolderName <String>
   [-LocalizedFolderName <MultiValuedProperty>]
   [-StorageQuota <Unlimited>]
   [-BaseFolderOnly <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LocalizedComment <MultiValuedProperty>]
   [-MustDisplayCommentEnabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

O cmdlet New-ManagedFolder cria uma nova pasta gerenciada no Active Directory. Depois que um novo objeto de pasta gerenciada for criado, as seguintes etapas precisam ser tomadas para usá-lo para MRM:

• Crie configurações de conteúdo gerenciado para a pasta. Para obter informações, consulte Criar Configurações de Conteúdo Gerenciado.
• Vincule a pasta gerenciada a uma política de caixa de correio de pasta gerenciada existente ou crie uma política de caixa de correio de pasta gerenciada e vincule a pasta gerenciada a ela.
• Aplique uma política de caixa de correio de pasta gerenciada à caixa de correio de um usuário. Para obter informações, consulteApply a Managed Folder Mailbox Policy to Users.
• Verifique se o assistente de pasta gerenciado está agendado ou execute o assistente de pasta gerenciado manualmente. Para obter informações sobre como agendar o assistente de pasta gerenciada, consulte Configurar o Assistente de Pasta Gerenciada. Quando o assistente de pasta gerenciado é executado, ele configura pastas padrão como gerenciadas e cria pastas personalizadas gerenciadas na caixa de correio do usuário com as configurações especificadas.
• Para obter mais informações sobre as etapas para implementar o MRM no Microsoft Exchange Server 2010, consulte Implantando o Gerenciamento de Registros de Mensagens.

Por padrão, 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 qual tipo de pasta padrão criar (por exemplo, uma pasta inbox adicional). Ao criar várias cópias de uma pasta padrão gerenciada, você pode atribuir diferentes configurações de conteúdo a cada uma delas. Por exemplo, você pode ter duas pastas de caixa de entrada, uma chamada InboxSixMonths e outra chamada InboxOneYear. Em seguida, você pode atribuir um tempo de retenção de seis meses à primeira pasta e um ano à segunda pasta com o cmdlet New-ManagedContentSettings (ou usando o assistente Novas Configurações de Conteúdo Gerenciado no Console de Gerenciamento do Exchange). Você deve atribuir um nome exclusivo (usando o parâmetro Nome) a cada uma das pastas padrão gerenciadas que você cria. Os usuários, no entanto, sempre veem o nome da pasta padrão nãoterizado. No exemplo, se os usuários recebem uma pasta InboxSixMonths ou uma pasta InboxOneYear, a caixa de entrada que eles veem em sua caixa de correio é rotulada como Caixa de Entrada. Embora os nomes de pasta que os usuários veem em suas caixas de correio possam ser reatribuídos para pastas personalizadas gerenciadas (usando o parâmetro FolderName do comando Set-ManagedFolder), os nomes de pastas vistos pelos usuários para pastas padrão gerenciadas não podem ser alterados.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

New-ManagedFolder -Name NewFolder -FolderName "New Folder" -StorageQuota "1 MB"

Este exemplo cria uma pasta gerenciada que tem uma capacidade máxima de 1 MB.

Exemplo 2

New-ManagedFolder -Name MyFolder -FolderName "My Folder" -LocalizedFolderName Spanish:"Mi Carpeta", French:"Mon Dossier" -Comment "My comment" -LocalizedComment Spanish:"Mi comentario", French:"Mon annotation"

Este exemplo cria uma pasta gerenciada que tem um nome de pasta padrão e um comentário em inglês, nome da pasta localizada em espanhol e francês e comentários localizados em espanhol e francês.

Exemplo 3

New-ManagedFolder -Name AnotherInbox -DefaultFolderType Inbox

Este exemplo cria uma instância da caixa de entrada da pasta padrão.

Parâmetros

-BaseFolderOnly

O parâmetro BaseFolderOnly especifica se as configurações de conteúdo gerenciado devem ser aplicadas apenas à pasta gerenciada ou à pasta e a todas as subpastas.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Comment

O parâmetro Comment especifica o comentário de administrador padrão a ser exibido com a pasta em Microsoft Office Outlook 2007 e Microsoft office Outlook Web App. O comentário pode ter até 255 caracteres, incluindo espaços.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

• Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-DefaultFolderType

O parâmetro DefaultFolderType especifica o tipo de pasta padrão a ser criada, como Caixa de Entrada ou Itens Excluídos.

Uma política de caixa de correio de pasta gerenciada pode ter apenas uma pasta gerenciada de cada tipo de pasta padrão. Pastas padrão adicionais de um tipo específico, como a Caixa de Entrada, podem ser criadas e adicionadas a políticas de caixa de correio diferentes. Isso permite atribuir diferentes configurações de conteúdo gerenciado para um tipo de pasta padrão específico para diferentes conjuntos de usuários.

Por exemplo, você pode ter duas pastas padrão do tipo Caixa de Entrada, uma com configurações de conteúdo gerenciado definidas para reter mensagens por um mês e outra com configurações para reter mensagens por um ano. Cada pasta padrão gerenciada deve ter um nome exclusivo (atribuído usando o parâmetro Nome).

Se um valor não for inserido para o parâmetro DefaultFolderType, ele será tratado como uma pasta personalizada gerenciada.

Os tipos de pasta padrão que você pode especificar são:

• Calendário
• Contatos
• Deleteditems
• Rascunhos
• Caixa de Entrada
• JunkEmail
• Diário
• Observações
• Caixa de saída
• SentItems
• Tarefas
• Todos
• ManagedCustomFolder
• RssSubscriptions
• SyncIssues
• ConversationHistory

Type:	DefaultManagedFolderType
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-DomainController

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-FolderName

O parâmetro FolderName especifica o nome da pasta conforme ele aparece nas caixas de correio dos usuários. O nome da pasta pode ter até 255 caracteres. Você não pode definir o parâmetro FolderName para pastas padrão gerenciadas, como a Caixa de Entrada.

O parâmetro FolderName não deve ser confundido com o parâmetro Name.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-LocalizedComment

O parâmetro LocalizedComment especifica comentários de administrador localizado e seus idiomas. Quando a configuração de idioma do Outlook 2007 corresponde a uma das localidades especificadas neste parâmetro, o comentário localizado correspondente é exibido. Os comentários devem estar no formulário ISOLanguageCode:Comment (por exemplo, -LocalizedComment EN-US:"Este é um comentário localizado em inglês dos EUA").

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-LocalizedFolderName

O parâmetro LocalizedFolderName especifica os nomes de pasta localizada e seus idiomas. Quando a configuração de idioma do Outlook 2007 corresponde a uma das localidades especificadas neste parâmetro, o nome da pasta localizada correspondente é exibido. Os nomes de pasta devem estar no formulário ISOLanguageCode:FolderName (por exemplo, -LocalizedFolderName EN-US:"Comercialmente Crítico").

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MustDisplayCommentEnabled

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Name

O parâmetro Name especifica um nome exclusivo para o objeto de pasta gerenciado no Active Directory. O nome pode ter até 65 caracteres. Enquanto o parâmetro FolderName especifica o nome da pasta conforme exibido aos usuários em clientes, o parâmetro Name é usado pelas ferramentas de administração do Exchange para representar o objeto de pasta gerenciada.

O parâmetro Name não deve ser confundido com o parâmetro FolderName.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-StorageQuota

O parâmetro StorageQuota especifica o limite de tamanho de armazenamento para a pasta caixa de correio. Quando o tamanho da pasta excede esse limite, nenhum item adicional pode ser adicionado. Os limites de tamanho de armazenamento podem ser especificados em quilobytes (KB) ou megabytes (MB), por exemplo, 100 KB ou 5 MB.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.