Set-MessageClassification
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-06-28
Mithilfe des Cmdlets Set-MessageClassification können Sie eine vorhandene Nachrichtenklassifikationsinstanz in Ihrer Exchange-Organisation konfigurieren.
Syntax
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>]]
Detaillierte Beschreibung
Damit Sie das Cmdlet Set-MessageClassification ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Organisationsadministrator
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter |
Der Parameter Identity kann einen Zeichenfolgenwert, der dem Wert von Name entspricht, oder die GUID verwenden. |
ClassificationID |
Optional |
System.Guid |
Verwenden Sie diesen Parameter, um eine GUID einer vorhandenen Nachrichtenklassifikation anzugeben, die Sie in Ihrer Exchange-Organisation verwenden möchten. Verwenden Sie diesen Parameter, wenn Sie Nachrichtenklassifikationen konfigurieren, die zwei Exchange-Gesamtstrukturen innerhalb derselben Organisation umfassen. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Confirm-Parameter muss kein Wert angegeben werden. |
DisplayName |
Optional |
System.String |
Verwenden Sie diesen Parameter, um den Anzeigenamen der Nachrichtenklassifikationsinstanz anzugeben. Der Anzeigename wird in Microsoft Office 2007 angezeigt und von Microsoft Outlook-Benutzern verwendet, um vor dem Senden einer Nachricht die geeignete Nachrichtenklassifikation auszuwählen. Wenn Sie einen Namen angeben, der Leerzeichen enthält, müssen Sie den gesamten Namen in doppelte Anführungszeichen einschließen, beispielsweise wie in |
DisplayPrecedence |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ClassificationDisplayPrecedenceLevel |
Verwenden Sie diesen Parameter, um den relativen Vorrang der Nachrichtenklassifikation anzugeben, den diese gegenüber anderen Nachrichtenklassifikationen besitzt, die möglicherweise auf eine Nachricht angewendet werden. Obwohl Outlook einem Benutzer nur die Angabe einer einzigen Nachrichtenklassifikation für eine Nachricht erlaubt, können andere Klassifikationen von Transportregeln angewendet werden. Dieser Parameter legt den Vorrang für eine vorgegebene Klassifikation fest, die dem Empfänger in Outlook angezeigt wird. Die Klassifikation mit dem höchsten Vorrang wird zuerst angezeigt. Die nachfolgenden Klassifikationen, deren Vorrang niedriger als der durch den Parameter definierte ist, werden in der entsprechend richtigen Reihenfolge angefügt. Gültige Eingaben für den Parameter DisplayPrecedence sind Der Standardwert ist |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu. Der Parameter DomainController wird nicht auf Computern unterstützt, auf denen die Serverfunktion Edge-Transport installiert ist. Die Serverfunktion Edge-Transport schreibt und liest nur in der lokalen ADAM-Instanz (Active Directory Application Mode). |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.MessageClassification |
Verwenden Sie diesen Parameter, um dem zu verarbeitenden Befehl ein vollständiges Objekt zu übergeben. Dieser Parameter wird hauptsächlich in Skripts verwendet, in denen ein vollständiges Objekt an den Befehl übergeben werden muss. |
Name |
Optional |
System.String |
Verwenden Sie diesen Parameter, um den administrativen Namen der Nachrichtenklassifikationsinstanz anzugeben. Dieser Name wird für die Verwaltung der Nachrichtenklassifikationsinstanz verwendet. Wenn Sie einen Namen angeben, der Leerzeichen enthält, müssen Sie den gesamten Namen in doppelte Anführungszeichen einschließen, beispielsweise wie in |
RecipientDescription |
Optional |
System.String |
Verwenden Sie diesen Parameter, um dem Empfänger zu erläutern, welchen Zweck die Nachrichtenklassifikation erfüllen soll. Der in diesen Parameter eingegebene Text wird von Outlook-Benutzern angezeigt, wenn sie eine Nachricht mit dieser Nachrichtenklassifikation empfangen. Schließen Sie die Beschreibung in doppelte Anführungszeichen ein, wie z. B. Wenn Sie für diesen Parameter keinen Wert angeben, wird die Beschreibung verwendet, die für den Parameter SenderDescription angegeben ist. |
RetainClassificationEnabled |
Optional |
System.Boolean |
Verwenden Sie diesen Parameter, um anzugeben, ob die Nachrichtenklassifikation mit der Nachricht erhalten bleiben soll, wenn sie weitergeleitet oder darauf geantwortet wird. Der Standardwert ist |
SenderDescription |
Optional |
System.String |
Verwenden Sie diesen Parameter, um dem Absender zu erläutern, welchen Zweck die Nachrichtenklassifikation erfüllen soll. Der in diesen Parameter eingegebene Text wird von Outlook-Benutzern verwendet, um vor dem Senden einer Nachricht die geeignete Nachrichtenklassifikation auszuwählen. Schließen Sie die Beschreibung in doppelte Anführungszeichen ein, wie z. B. |
UserDisplayEnabled |
Optional |
System.Boolean |
Wenn der Parameter UserDisplayEnabled auf Der Standardwert ist |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den WhatIf-Parameter muss kein Wert angegeben werden. |
Beispiel
Das folgende Codebeispiel legt die Vertraulichkeitsaktion auf "None" (Keine) und den Anzeigevorrang für die Nachrichtenklassifikationsinstanz, die einen Parameter Identity mit dem Wert "Example" hat, auf "false" fest. Darüber hinaus wird festgelegt, dass die Nachrichtenklassifikation nicht mit der Nachricht erhalten bleiben soll, wenn sie weitergeleitet oder darauf geantwortet wird.
Set-MessageClassification -Identity Example -ConfidentialityAction None -DisplayPrecedence -RetainClassificationEnabled: $false