Compartilhar via

New-MessageClassification

  • Artigo

 

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

Tópico modificado em: 2007-06-28

Use o cmdlet New-MessageClassification para criar uma nova instância de classificação de mensagem em sua organização do Exchange. Depois de criar uma nova classificação de mensagem, você poderá especificá-la como um predicado de regra de transporte. Antes que os usuários do Microsoft Office Outlook 2007 e do Outlook Web Access 2007 possam aplicar a classificação às mensagens, atualize os sistemas de usuário final com o arquivo XML de classificação de mensagem criado pelo arquivo de script Export-OutlookClassification.ps1. O arquivo de script Export-OutlookClassification.ps1 está localizado no diretório \Arquivos de Programas\Microsoft\Exchange Server\Scripts.

Quando você cria uma nova classificação de mensagem, ela não tem localidade. Por padrão, a nova classificação de mensagem é usada para todas as localidades. Depois que uma classificação de mensagem padrão for definida, você poderá adicionar novas localidades da classificação executando o cmdlet New-MessageClassification e especificando a identidade da classificação de mensagem padrão que você deseja localizar.

Sintaxe

New-MessageClassification -Name <String> -DisplayName <String> -SenderDescription <String> [-ClassificationID <Guid>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-RecipientDescription <String>] [-TemplateInstance <PSObject>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

New-MessageClassification -Identity <MessageClassificationIdParameter> -Locale <CultureInfo> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientDescription <String>] [-SenderDescription <String>] [-TemplateInstance <PSObject>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet New-MessageClassification, você deve usar uma conta à qual estejam delegadas as seguintes funções:

  • 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 Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

DisplayName

Necessário

System.String

Use o parâmetro DisplayName para especificar o nome para exibição da instância de classificação de mensagem. O nome para exibição aparece no Office 2007 e é utilizado por usuários do Outlook para a seleção da classificação de mensagem apropriada antes do envio de uma mensagem.

Dica

O arquivo XML de classificação de mensagem deve estar presente no computador do remetente para que o nome para exibição seja mostrado.

Se o parâmetro UserDisplayEnabled estiver definido como $true, o nome para exibição será mostrado para o destinatário, mesmo se não houver nenhum arquivo XML de classificação de mensagem instalado.

Quando especificar um nome que inclua espaços, você deverá colocar o nome inteiro entre aspas, da seguinte maneira, por exemplo, "Display Name". O parâmetro DisplayName deve conter 64 caracteres ou menos.

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter

Use esse parâmetro para criar uma versão traduzida de uma classificação de mensagem existente. Você também deve especificar o parâmetro Locale. O parâmetro Identity pode ter o valor de uma cadeia de caracteres, que é o valor Name de uma classificação de mensagem existente.

Locale

Necessário

System.Globalization.CultureInfo

A especificação de um código de cultura para o parâmetro Locale cria uma versão específica de localidade da classificação de mensagem. Você também deve transmitir o parâmetro Identity da classificação de mensagem padrão existente ao criar uma nova versão específica da localidade.

Entradas válidas para o parâmetro Locale são os nomes das cadeias de caracteres listados na coluna Nome da Cultura na referência de classe da Biblioteca de Classes do Microsoft .NET que está disponível em CultureInfo.

Name

Necessário

System.String

Esse parâmetro especifica o nome administrativo da instância de classificação da mensagem. O nome é usado para administrar a instância de classificação da mensagem. Quando especificar um nome que inclua espaços, você deverá colocar o nome inteiro entre aspas, da seguinte maneira, por exemplo, "Adminstrative Name". O parâmetro Name deve conter 256 caracteres ou menos.

SenderDescription

Necessário

System.String

Use esse parâmetro para explicar ao remetente qual seria o objetivo da classificação da mensagem. O texto digitado nesse parâmetro é utilizado por usuários do Outlook para selecionar a classificação de mensagem apropriada antes do envio de uma mensagem. Coloque a descrição entre aspas, da seguinte maneira, por exemplo, "This is the sender description that explains when to use this message classification". O parâmetro SenderDescription deve conter no máximo 1.024 caracteres.

ClassificationID

Opcional

System.Guid

Use esse parâmetro para especificar a identificação de uma classificação de mensagem existente que você deseja importar e usar na organização do Exchange. Use esse parâmetro se estiver configurando classificações de mensagens que abrangem duas florestas do Exchange na mesma empresa.

Confirm

Optional

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 do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. O parâmetro DomainController não tem suporte em computadores em que a função de servidor Transporte de Borda está instalada. A função de servidor Transporte de Borda grava e lê apenas na instância local do Active Directory Application Mode (ADAM).

RecipientDescription

Opcional

System.String

Use esse parâmetro para explicar ao destinatário qual seria o objetivo da classificação da mensagem. O texto digitado nesse parâmetro é visualizado por usuários do Outlook quando eles recebem uma mensagem que contém essa classificação de mensagem. Coloque a descrição entre aspas, da seguinte maneira, por exemplo, "This is the recipient description that explains how to treat the message that has been classified". O parâmetro RecipientDescription deve conter 1.024 caracteres ou menos.

Se você não digitou um valor para esse parâmetro, a descrição que você digitou para SenderDescription será usada.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Quando um objeto existente for fornecido para o parâmetro TemplateInstance, o comando usará a configuração desse objeto para criar uma cópia idêntica do objeto em um servidor local ou de destino.

UserDisplayEnabled

Opcional

System.Boolean

Use esse parâmetro para especificar se os valores digitados para os parâmetros DisplayName e RecipientDescription são exibidos na mensagem do Outlook do destinatário.

Se você definir o parâmetro UserDisplayEnabled como $false, as mensagens enviadas para os destinatários e que contenham essa classificação não exibirão informação sobre classificação.

O valor padrão é $true.

Confirm

Optional

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.

WhatIf

Optional

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.

Exemplo

O exemplo de código a seguir mostra três exemplos que usam o cmdlet New-MessageClassification.

O primeiro exemplo mostra o comando New-MessageClassification que possui os parâmetros necessários.

O segundo exemplo mostra como criar uma versão específica de localidade (Espanhol - Espanha) de uma classificação de mensagem existente.

O terceiro exemplo mostra como criar outra versão específica de localidade (Espanhol - México) de uma classificação de mensagem existente.

New-MessageClassification -Name Example -DisplayName "New Message Classification" -SenderDescription "This is the description text"
New-MessageClassification -Identity Example -Locale es-ES -DisplayName "España Example " -SenderDescription "Este es el texto de la descripción"
New-MessageClassification -Identity Example -Locale es-MX -DisplayName "México Example" -SenderDescription "Este es el texto de la descripción"