New-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 New-MessageClassification können Sie eine neue Nachrichtenklassifikationsinstanz in Ihrer Exchange-Organisation erstellen. Nach dem Erstellen einer neuen Nachrichtenklassifikation können Sie diese Nachrichtenklassifikation als Prädikat einer Transportregel angeben. Damit Benutzer von Microsoft Office Outlook 2007 und Outlook Web Access 2007 die Nachrichtenklassifikation auf Nachrichten anwenden können, müssen Sie die Endbenutzersysteme mit der Nachrichtenklassifikations-XML-Datei aktualisieren, die von der Skriptdatei Export-OutlookClassification.ps1 erstellt wird. Die Skriptdatei Export-OutlookClassification.ps1 befindet sich im Verzeichnis \Programme\Microsoft\Exchange Server\Scripts.
Wenn Sie eine neue Nachrichtenklassifikation erstellen, verfügt diese über kein Gebietsschema. Die neue Nachrichtenklassifikation wird standardmäßig für alle Gebietsschemas verwendet. Nachdem eine Standardnachrichtenklassifikation definiert wurde, können Sie der Klassifikation neue Gebietsschemas hinzufügen, indem Sie das Cmdlet New-MessageClassification ausführen und die zu lokalisierende Standardnachrichtenklassifikations-Identität angeben.
Syntax
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>]]
Detaillierte Beschreibung
Damit Sie das Cmdlet New-MessageClassification ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- Exchange-Organisationsadministrator (Rolle)
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 |
|---|---|---|---|
DisplayName |
Erforderlich |
System.String |
Verwenden Sie den Parameter DisplayName, um den Anzeigenamen der Nachrichtenklassifikationsinstanz anzugeben. Der Anzeigename wird in Office 2007 angezeigt und von Outlook-Benutzern verwendet, um vor dem Senden einer Nachricht die geeignete Nachrichtenklassifikation auszuwählen. Hinweis Die Nachrichtenklassifikations-XML-Datei muss auf dem Computer des Absenders vorhanden sein, damit der Anzeigename angezeigt werden kann. Wenn der Parameter UserDisplayEnabled auf Wenn Sie einen Namen angeben, der Leerzeichen enthält, müssen Sie den gesamten Namen in doppelte Anführungszeichen einschließen, beispielsweise wie in |
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter |
Verwenden Sie diesen Parameter, um eine übersetzte Version einer vorhandenen Nachrichtenklassifikation zu erstellen. Sie müssen außerdem den Parameter Locale angeben. Der Parameter Identity akzeptiert einen Zeichenfolgenwert, der dem Wert des Parameters Name einer vorhandenen Nachrichtenklassifikation entspricht. |
Locale |
Erforderlich |
System.Globalization.CultureInfo |
Durch das Angeben eines Kulturcodes für den Parameter Locale wird eine gebietsschemaspezifische Version der Nachrichtenklassifikation erstellt. Beim Erstellen einer neuen gebietsschemaspezifischen Version müssen Sie auch den Parameter Identity der vorhandenen Standardnachrichtenklassifikation übergeben. Gültige Eingabewerte für den Parameter Locale sind die Zeichenfolgenamen, die in der Spalte Culture Name der Klassenreferenz der Microsoft .NET-Klassenbibliothek aufgeführt sind. Die Klassenreferenz ist unter CultureInfo verfügbar. |
Name |
Erforderlich |
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 |
SenderDescription |
Erforderlich |
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. |
ClassificationID |
Optional |
System.Guid |
Verwenden Sie diesen Parameter, um eine Klassifikations-ID einer vorhandenen Nachrichtenklassifikation anzugeben, die Sie in Ihre Exchange-Organisation importieren und dort verwenden möchten. Verwenden Sie diesen Parameter, wenn Sie Nachrichtenklassifikationen konfigurieren, die zwei Exchange-Gesamtstrukturen innerhalb desselben Unternehmens 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. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen 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). |
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. |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
Wenn ein vorhandenes Objekt an den Parameter TemplateInstance übergeben wird, verwendet der Befehl die Konfiguration dieses Objekts zum Erstellen einer identischen Kopie des Objekts auf einem lokalen oder Zielserver. |
UserDisplayEnabled |
Optional |
System.Boolean |
Verwenden Sie diesen Parameter, um anzugeben, ob die für die Parameter DisplayName und RecipientDescription eingegebenen Werte in der Outlook-Nachricht des Empfängers angezeigt werden. Wenn der Parameter UserDisplayEnabled auf Der Standardwert ist |
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. |
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 zeigt drei Beispiele, die das Cmdlet New-MessageClassification verwenden.
Das erste Codebeispiel zeigt den Befehl New-MessageClassification, der über die erforderlichen Parameter verfügt.
Das zweite Beispiel zeigt, wie eine gebietsschemaspezifische (Spanisch - Spanien) Version einer vorhandenen Nachrichtenklassifikation erstellt wird.
Das dritte Beispiel zeigt, wie eine weitere gebietsschemaspezifische (Spanisch - Mexiko) Version einer vorhandenen Nachrichtenklassifikation erstellt wird.
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"