New-ManagedContentSettings
Este cmdlet só está disponível no Exchange Server 2010.
Utilize o cmdlet New-ManagedContentSettings para criar definições de conteúdo gerido para pastas geridas.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
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 definições de conteúdo gerido são definições que associa a pastas geridas para controlar o tempo de vida dos itens nas caixas de correio dos utilizadores. O tempo de vida é controlado das seguintes formas:
- Ao controlar a retenção de conteúdos e remover conteúdos que já não são necessários.
- Ao enviar automaticamente um diário de conteúdos importantes para uma localização de armazenamento separada fora da caixa de correio.
Para obter mais informações sobre as definições de conteúdo gerido, veja Gestão de Registos de Mensagens.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 definições de conteúdo gerido para a pasta predefinida gerida Exec-DeletedItems. Quando adicionados a uma política de caixa de correio de pasta gerida e aplicados a uma caixa de correio, os itens na pasta Itens Eliminados são eliminados permanentemente a 30 dias 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 definições de conteúdo gerido CS-Exec-Calendar para a classe de mensagens Calendário. As definições de conteúdo gerido aplicam-se ao Calendário da pasta predefinida. A retenção está ativada e os itens são movidos para a pasta Itens Eliminados após 180 dias.
Parâmetros
-AddressForJournaling
Aplicável: Exchange Server 2010
O parâmetro AddressForJournaling especifica o destinatário do diário para onde as mensagens em 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
Este parâmetro é 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. 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, 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 confirmar 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 diário está ativado 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 as definições de configuração de expiração e de registo de diários nestas definições de conteúdo.
O valor do parâmetro pode ser um tipo de mensagem bem conhecido, como itens de Calendário, uma classe de mensagem específica, como IPM. NOTA. SMIME ou uma classe de mensagem personalizada. Podem ser utilizados os seguintes tipos de mensagens conhecidos:
- Para Todo o conteúdo da caixa de correio, utilize o valor *.
- Para o tipo de mensagem Itens de calendário, utilize o valor IPM. Compromisso*.
- Para o tipo de mensagem Contactos, utilize o valor IPM. Contacto*.
- Para o tipo de mensagem Documentos, utilize o valor IPM. Documento*.
- Para o tipo de mensagem Faxes, utilize o valor IPM. Note.Microsoft.Fax.
- Para o tipo de mensagem Journalitems, utilize o valor IPM. Atividade.
- Para o tipo de mensagem Pedidos de reunião, respostas e cancelamentos, utilize o valor IPM. Agenda*.
- Para o tipo de mensagem Notas, utilize o valor IPM. StickyNote.
- Para o tipo de mensagem Mensagens, utilize o valor IPM.Post.
- Para o tipo de mensagem itens RSS, utilize o valor IPM. Post.RSS.
- Para o tipo de mensagem Tarefas, utilize o valor IPM. Tarefa*.
- Para o tipo de mensagem Voice mail, utilize 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. NOTA).
- O caráter universal asterisco (*), que indica que as definições de conteúdo se aplicam a todas as classes de mensagens.
- Uma classe de mensagem específica que tem o caráter universal asterisco. O caráter universal asterisco tem de aparecer como o último caráter na classe de mensagem. Por exemplo, IPM. NOTA* (inclui O IPM. NOTA e todas as subclasses) ou IPM. NOTA.* (inclui as subclasses do IPM. NOTA, mas não IPM. NOTA propriamente dita). *. NOTA e IPM.*. NOTA não são valores válidos.
Observações:
- Quando são utilizados carateres universais, estas políticas aplicam-se apenas a classes de mensagens que não têm uma definição de conteúdo específica. Por conseguinte, o IPM. NOTA. O SMIME substitui o IPM. NOTA.*.
- As definições específicas substituem as definições gerais, por exemplo, o Voicemail 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 no qual um item deve ser registado em diário. É possível usar os seguintes valores:
- UseMsg Outlook .msg format (Formato useMsg do Outlook .msg)
- Utilizar o formato MAPI do Outlook do UseTnef
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 tem de ser uma pasta personalizada gerida existente. Se não estiver, é devolvido um erro. Se o parâmetro MoveToDestinationFolder não estiver presente e o valor do parâmetro RetentionAction for MoveToFolder, é devolvido um erro.
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 é ativada 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 o respetivo limite de retenção um número específico de dias após o item ter sido entregue ou depois de ter sido movido para uma pasta.
Os valores válidos incluem:
- Quando Entregue
- Quando Movido
Este valor corresponde ao bit 0x4 do atributo msExchELCFlags no Active Directory. O sinalizador está 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 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.
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 suporta os 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.