New-ManagedFolder
Este cmdlet está disponível apenas no Exchange Server 2010.
Use o cmdlet New-ManagedFolder para criar um objeto de pasta gerenciada para gerenciamento de registros de mensagens (MRM).
Este comando não aceita entrada canalizada.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
ManagedDefaultFolder
New-ManagedFolder
[-Name] <String>
-DefaultFolderType <DefaultManagedFolderType>
[-BaseFolderOnly <Boolean>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-LocalizedComment <MultiValuedProperty>]
[-MustDisplayCommentEnabled <Boolean>]
[-WhatIf]
[<CommonParameters>]
ManagedCustomFolder
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 é criado, as seguintes etapas precisam ser executadas 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.
- Aplicar uma política de caixa de correio de pasta gerenciada à caixa de correio de um usuário. Para obter informações, consulte Aplicar uma política de caixa de correio de pasta gerenciada aos usuários.
- Verifique se o assistente de pasta gerenciada está agendado ou execute o assistente de pasta gerenciada 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 gerenciada é executado, ele configura as pastas padrão como gerenciadas e cria todas as 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 o tipo de pasta padrão a 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 diferentes configurações de conteúdo a cada uma. Por exemplo, você pode ter duas pastas da Caixa de Entrada, uma chamada InboxSixMonths e outra chamada InboxOneYear. Em seguida, você poderia atribuir um tempo de retenção de seis meses para a primeira pasta e um ano para a segunda pasta com o cmdlet New-ManagedContentSettings (ou usando o assistente para Novas Configurações de Conteúdo Gerenciado na 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ê criar. Os usuários, no entanto, sempre veem o nome da pasta padrão inalterado. 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 será rotulada como Caixa de Entrada. Embora os nomes de pastas 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 artigo 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 com 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 com um nome de pasta padrão e um comentário em inglês, um nome de pasta localizado em espanhol e francês e um comentário localizado em espanhol e francês.
Exemplo 3
New-ManagedFolder -Name AnotherInbox -DefaultFolderType Inbox
Este exemplo cria uma instância da pasta padrão Caixa de Entrada.
Parâmetros
-BaseFolderOnly
Aplicável: Exchange Server 2010
O parâmetro BaseFolderOnly especifica se as configurações de conteúdo gerenciado devem ser aplicadas somente à pasta gerenciada ou à pasta e todas as suas subpastas.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Comment
Aplicável: Exchange Server 2010
O parâmetro Comment especifica o comentário padrão do administrador a ser exibido com a pasta no Microsoft Office Outlook 2007 e Microsoft Office Outlook Web App. O comentário pode ter até 255 caracteres, incluindo espaços.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2010
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DefaultFolderType
Aplicável: Exchange Server 2010
O parâmetro DefaultFolderType especifica o tipo de pasta padrão a ser criado, 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 Caixa de Entrada, podem ser criadas e adicionadas a diferentes políticas de caixa de correio. Isso permite atribuir diferentes configurações de conteúdo gerenciado a 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 Name).
Se um valor não for inserido para o parâmetro DefaultFolderType, ela será tratada 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
- Lixo eletrônico
- Diário
- Observações
- Caixa de saída
- SentItems
- Tarefas
- Todos
- ManagedCustomFolder
- RssSubscriptions
- SyncIssues
- História da conversa
Propriedades do parâmetro
| Tipo: | DefaultManagedFolderType |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ManagedDefaultFolder
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-FolderName
Aplicável: Exchange Server 2010
O parâmetro FolderName especifica o nome da pasta como ele aparece nas caixas de correio dos usuários. O nome da pasta pode ter até 255 caracteres. Não é possível 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ManagedCustomFolder
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-LocalizedComment
Aplicável: Exchange Server 2010
O parâmetro LocalizedComment especifica comentários localizados do administrador 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 formato ISOLanguageCode:Comment (por exemplo, -LocalizedComment EN-US:"This is a localized comment in U.S. English").
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-LocalizedFolderName
Aplicável: Exchange Server 2010
O parâmetro LocalizedFolderName especifica os nomes de pastas localizadas 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 pastas devem estar no formato ISOLanguageCode:FolderName (por exemplo, -LocalizedFolderName EN-US:"Business Critical").
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ManagedCustomFolder
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MustDisplayCommentEnabled
Aplicável: Exchange Server 2010
O parâmetro MustDisplayCommentEnabled especifica se um sinalizador usado pelo Outlook 2007 deve ser definido para impedir que os usuários minimizem um comentário de pasta (visível no Outlook 2007 e no 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.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Exchange Server 2010
O parâmetro Name especifica um nome exclusivo para o objeto de pasta gerenciada no Active Directory. O nome pode ter até 65 caracteres. Enquanto o parâmetro FolderName especifica o nome da pasta conforme exibido para 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-StorageQuota
Aplicável: Exchange Server 2010
O parâmetro StorageQuota especifica o limite de tamanho de armazenamento para a pasta da caixa de correio. Quando o tamanho da pasta exceder esse limite, nenhum item adicional poderá ser adicionado. Os limites de tamanho de armazenamento podem ser especificados em quilobytes (KB) ou megabytes (MB), por exemplo, 100 KB ou 5 MB.
Propriedades do parâmetro
| Tipo: | Unlimited |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ManagedCustomFolder
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.