New-ManagedContentSettings
Este cmdlet está disponível apenas no Exchange Server 2010.
Use o cmdlet New-ManagedContentSettings para criar configurações de conteúdo gerenciado para pastas gerenciadas.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
New-ManagedContentSettings
[-Name] <String>
-FolderName <ELCFolderIdParameter>
-MessageClass <String>
[-AddressForJournaling <RecipientIdParameter>]
[-AgeLimitForRetention <EnhancedTimeSpan>]
[-Confirm]
[-DomainController <Fqdn>]
[-JournalingEnabled <Boolean>]
[-LabelForJournaling <String>]
[-MessageFormatForJournaling <JournalingFormat>]
[-MoveToDestinationFolder <ELCFolderIdParameter>]
[-RetentionAction <RetentionAction>]
[-RetentionEnabled <Boolean>]
[-TriggerForRetention <RetentionDateType>]
[-WhatIf]
[<CommonParameters>]
Description
As configurações de conteúdo gerenciado são configurações que você associa a pastas gerenciadas para controlar o tempo de vida dos itens nas caixas de correio dos usuários. A vida útil é controlada das seguintes maneiras:
- Controlando a retenção de conteúdo e removendo o conteúdo que não é mais necessário.
- Registrando automaticamente no diário conteúdo importante em um local de armazenamento separado fora da caixa de correio.
Para obter mais informações sobre configurações de conteúdo gerenciado, consulte Gerenciamento de registros de mensagens.
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-ManagedContentSettings -Name "CS-Exec-DeletedItems" -FolderName "Exec-DeletedItems" -MessageClass * -RetentionEnabled $true -RetentionAction DeleteAndAllowRecovery -AgeLimitForRetention 30.00:00:00 -TriggerForRetention WhenDelivered
Este exemplo cria configurações de conteúdo gerenciado para a pasta padrão gerenciada Exec-DeletedItems. Quando adicionados a uma política de caixa de correio de pasta gerenciada e aplicados a uma caixa de correio, os itens na pasta Itens Excluídos são excluídos permanentemente 30 dias a partir da data de entrega.
Exemplo 2
New-ManagedContentSettings -Name CS-Exec-Calendar -FolderName Exec-Calendar -MessageClass Calendar -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention 180
Este exemplo cria configurações de conteúdo gerenciado CS-Exec-Calendar para a classe de mensagem Calendar. As configurações de conteúdo gerenciado se aplicam à pasta padrão Calendar. A retenção é habilitada e os itens são movidos para a pasta Itens Excluídos após 180 dias.
Parâmetros
-AddressForJournaling
Aplicável: Exchange Server 2010
O parâmetro AddressForJournaling especifica o destinatário de registro no diário para onde as mensagens registradas no diário são enviadas. É possível usar qualquer valor que identifique o destinatário com exclusividade. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- DN canônico
- GUID
Esse parâmetro será necessário se o parâmetro JournalingEnabled estiver definido como $true.
Propriedades do parâmetro
| Tipo: | RecipientIdParameter |
| 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 |
-AgeLimitForRetention
Aplicável: Exchange Server 2010
O parâmetro AgeLimitForRetention especifica a idade com que a retenção é imposta a um item. O limite de idade corresponde ao número de dias a contar da data em que o item foi entregue ou da data em que um item foi criado, se não tiver sido entregue. Se esse parâmetro não estiver presente e o parâmetro RetentionEnabled estiver definido como $true, um erro será retornado.
Propriedades do parâmetro
| Tipo: | EnhancedTimeSpan |
| 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 |
-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 ou o GUID da pasta gerenciada à qual as configurações de conteúdo gerenciado se aplicam.
Propriedades do parâmetro
| Tipo: | ELCFolderIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-JournalingEnabled
Aplicável: Exchange Server 2010
O parâmetro JournalingEnabled especifica que o registro no diário é habilitado quando definido como $true.
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 |
-LabelForJournaling
Aplicável: Exchange Server 2010
O parâmetro LabelForJournaling especifica um rótulo anexado a um item. Esse rótulo é usado pelo repositório de destino para determinar o conteúdo do item e impor a diretiva apropriada.
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 |
-MessageClass
Aplicável: Exchange Server 2010
O parâmetro MessageClass especifica o tipo de mensagem ao qual se aplicam todas as definições de configuração de expiração e registro em diário dentro dessas configurações de conteúdo.
O valor do parâmetro pode ser um tipo de mensagem bem conhecido, como Itens do Calendar, uma classe de mensagem específica como IPM. OBSERVAÇÃO. SMIME ou uma classe de mensagem personalizada. Os seguintes tipos de mensagens conhecidas podem ser usados:
- Para Todo o conteúdo da caixa de correio, use o valor *.
- Para o tipo de mensagem Calendar items, use o valor IPM. Nomeação*.
- Para o tipo de mensagem Contatos, use o valor IPM. Contato*.
- Para o tipo de mensagem Documentos, use o valor IPM. Documento*.
- Para o tipo de mensagem Faxes, use o valor IPM. Note.Microsoft.Fax.
- Para o tipo de mensagem Journalitems, use o valor IPM. Atividade.
- Para o tipo de mensagem Solicitações de reunião, respostas e cancelamentos, use o valor IPM. Agenda*.
- Para o tipo de mensagem Anotações, use o valor IPM. Nota Autoadesiva.
- Para o tipo de mensagem Post, use o valor IPM.Post.
- Para o tipo de mensagem de itens RSS, use o valor IPM. Post.RSS.
- Para o tipo de mensagem Tarefas, use o valor IPM. Tarefa*.
- Para o tipo de mensagem de Caixa postal, use o valor IPM. Note.Microsoft.Voicemail*.
Os valores de parâmetro válidos para classes de mensagens personalizadas incluem:
- Uma classe de mensagem específica (por exemplo, IPM. OBSERVAÇÃO).
- O caractere curinga asterisco (*), que indica que as configurações de conteúdo se aplicam a todas as classes de mensagem.
- Uma classe de mensagem específica que tem o caractere curinga asterisco. O caractere curinga asterisco deve aparecer como o último caractere na classe de mensagem. Por exemplo, IPM. OBSERVAÇÃO* (inclui IPM. OBSERVAÇÃO e todas as subclasses) ou IPM. NOTA.* (inclui as subclasses para IPM. OBSERVAÇÃO, mas não IPM. NOTA em si). *. NOTA e IPM.*. OBSERVAÇÃO não são valores válidos.
Observações:
- Quando caracteres curinga são usados, essas políticas se aplicam somente a classes de mensagem que não têm uma configuração de conteúdo específica. Portanto, o IPM. OBSERVAÇÃO. O SMIME substitui o IPM. OBSERVAÇÃO.*.
- Configurações específicas substituem as configurações gerais, por exemplo, Caixa postal substitui AllMailboxContent.
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: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MessageFormatForJournaling
Aplicável: Exchange Server 2010
O parâmetro MessageFormatForJournaling especifica o formato de mensagem em que um item deve ser registrado no diário. É possível usar os seguintes valores:
- UseMsg Formato .msg do Outlook
- UseTnef Formato MAPI do Outlook
Propriedades do parâmetro
| Tipo: | JournalingFormat |
| 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 |
-MoveToDestinationFolder
Aplicável: Exchange Server 2010
O parâmetro MoveToDestinationFolder especifica a pasta de destino para uma ação de movimentação.
A pasta de destino deve ser uma pasta personalizada gerenciada existente. Se não estiver, um erro será retornado. Se o parâmetro MoveToDestinationFolder não estiver presente e o valor do parâmetro RetentionAction for MoveToFolder, um erro será retornado.
Propriedades do parâmetro
| Tipo: | ELCFolderIdParameter |
| 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 as configurações de conteúdo gerenciado.
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 |
-RetentionAction
Aplicável: Exchange Server 2010
O parâmetro RetentionAction especifica uma das seguintes ações:
- Marcar como fora do limite de retenção
- Mover para uma pasta personalizada gerenciada
- Mover para a pasta Itens Excluídos
- Excluir e permitir recuperação
- Excluir permanentemente
Se esse parâmetro não estiver presente e o parâmetro RetentionEnabled estiver definido como $true, um erro será retornado.
Propriedades do parâmetro
| Tipo: | RetentionAction |
| 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 |
-RetentionEnabled
Aplicável: Exchange Server 2010
O parâmetro RetentionEnabled especifica que a retenção é habilitada quando definida como $true.
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 |
-TriggerForRetention
Aplicável: Exchange Server 2010
O parâmetro TriggerForRetention especifica a data considerada como a data de início do período de retenção. Um item pode atingir seu limite de retenção um número específico de dias após a entrega do item ou depois de ter sido movido para uma pasta.
Os valores válidos incluem:
- WhenDelivered
- WhenMoved
Esse valor corresponde ao bit 0x4 do atributo msExchELCFlags no Active Directory. O sinalizador é definido como $true se o item expirar com base na data em que foi movido e $false se o item expirar com base na data de entrega.
Se esse parâmetro não estiver presente e o parâmetro RetentionEnabled estiver definido como $true, um erro será retornado.
Propriedades do parâmetro
| Tipo: | RetentionDateType |
| 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 |
-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.