Compartilhar via

Set-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 Set-MessageClassification para configurar uma instância de classificação de mensagens existente na organização do Exchange.

Sintaxe

Set-MessageClassification -Identity <MessageClassificationIdParameter> [-ClassificationID <Guid>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayPrecedence <Highest | Higher | High | MediumHigh | Medium | MediumLow | Low | Lower | Lowest>] [-DomainController <Fqdn>] [-Name <String>] [-RecipientDescription <String>] [-RetainClassificationEnabled <$true | $false>] [-SenderDescription <String>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-MessageClassification [-ClassificationID <Guid>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayPrecedence <Highest | Higher | High | MediumHigh | Medium | MediumLow | Low | Lower | Lowest>] [-DomainController <Fqdn>] [-Instance <MessageClassification>] [-Name <String>] [-RecipientDescription <String>] [-RetainClassificationEnabled <$true | $false>] [-SenderDescription <String>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet Set-MessageClassification, você deve usar a conta à qual esteja delegado o seguinte:

  • 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

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter

O parâmetro Identity pode ter um valor de cadeia de caracteres, que é o valor Name ou a GUID.

ClassificationID

Opcional

System.Guid

Use esse parâmetro para especificar a GUID de uma classificação de mensagem existente que você deseja usar na organização do Exchange. Use esse parâmetro se você estiver configurando as classificações de mensagem para abranger duas florestas do Exchange na mesma organização.

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.

DisplayName

Opcional

System.String

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

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.

DisplayPrecedence

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ClassificationDisplayPrecedenceLevel

Use esse parâmetro para especificar a precedência relativa da classificação da mensagem sobre outras classificações de mensagens que podem ser aplicadas a uma mensagem específica. Embora o Outlook só permita que um usuário especifique uma única classificação para uma determinada mensagem, as regras de transporte podem ser aplicadas a outras classificações. Esse parâmetro define a precedência em uma classificação específica para o que é exibido para o destinatário no Outlook. A classificação com a maior precedência é mostrada primeiro, e as classificações subseqüentes, que são aquelas com menor precedência, conforme definido por esse parâmetro, são anexadas na ordem apropriada desse momento em diante.

A entrada válida para o parâmetro DisplayPrecedence é Highest, Higher, High, MediumHigh, Medium, MediumLow, Low, Lower ou Lowest.

O valor padrão é Mediuum.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) 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).

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.MessageClassification

Use esse parâmetro para passar um objeto inteiro para o comando para ser processado. Esse parâmetro é usado principalmente em scripts em que um objeto inteiro deve ser passado para o comando.

Name

Opcional

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.

RecipientDescription

Opcional

System.String

Use esse parâmetro para explicar ao destinatário qual seria o objetivo da classificação da mensagem. O texto que você digitar nesse parâmetro é visualizado por usuários do Outlook quando eles receberem uma mensagem que tenha 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.

RetainClassificationEnabled

Opcional

System.Boolean

Use esse parâmetro para especificar se a classificação de mensagem deve persistir na mensagem se a mensagem for encaminhada ou respondida.

O valor padrão é $true.

SenderDescription

Opcional

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 é usado pelos usuários do Outlook para selecionar a classificação de mensagem apropriada antes que a mensagem seja enviada. 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.

UserDisplayEnabled

Opcional

System.Boolean

Quando o parâmetro UserDisplayEnabled é definido como $true, ele mostra o texto que você digitou nos parâmetros DisplayName e RecipientDescription para o destinatário das mensagens que são enviadas com essa classificação de mensagem.

O valor padrão é $true.

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 define a ação de confidencialidade como "Nenhuma" e a precedência de exibição como "falsa" para a instância de classificação de mensagem que tiver um parâmetro de Identity igual a "Example". Ele também especifica que a classificação de mensagem não deve persistir na mensagem se a mensagem for encaminhada ou respondida.

Set-MessageClassification -Identity Example -ConfidentialityAction None -DisplayPrecedence -RetainClassificationEnabled: $false