Set-MessageClassification

 

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