Set-OMEConfiguration
Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.
Verwenden Sie das Cmdlet Set-OMEConfiguration, um Microsoft Purview-Nachrichtenverschlüsselung zu konfigurieren.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standardwert)
Set-OMEConfiguration
[-Identity] <OMEConfigurationIdParameter>
[-BackgroundColor <String>]
[-Confirm]
[-DisclaimerText <String>]
[-EmailText <String>]
[-ExternalMailExpiryInDays <Int32>]
[-Image <Byte[]>]
[-IntroductionText <String>]
[-OTPEnabled <Boolean>]
[-PortalText <String>]
[-PrivacyStatementUrl <String>]
[-ReadButtonText <String>]
[-SocialIdSignIn <Boolean>]
[-WhatIf]
[<CommonParameters>]
Beschreibung
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.
Beispiele
Beispiel 1
Set-OMEConfiguration -Identity "OME Configuration" -EmailText "Encrypted message enclosed." -PortalText "This portal is encrypted." -DisclaimerText "Encryption security disclaimer." -Image ([System.IO.File]::ReadAllBytes('C:\Temp\OME Logo.gif'))
In diesem Beispiel werden die angegebenen Werte für die Standard-OME-Konfiguration namens "OME-Konfiguration" konfiguriert.
Parameter
-BackgroundColor
Anwendbar: Exchange Online, Exchange Online Protection
Der Parameter "BackgroundColor" legt die Hintergrundfarbe fest. Gültige Werte sind:
- Ein html-hexadezimaler Farbcodewert (#RRGGBB), der in Anführungszeichen eingeschlossen ist. Ist z. B
"#FFFFFF". weiß. - Ein gültiger Farbnamewert. Ist z.
yellowB. #ffff00. Eine Liste der gültigen Farbnamen finden Sie unter Referenz zur Hintergrundfarbe. - $null (leer). Dieser Wert ist die Standardeinstellung.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Anwendbar: Exchange Online, Exchange Online Protection
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.
- Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DisclaimerText
Anwendbar: Exchange Online, Exchange Online Protection
Der Parameter "DisclaimerText" gibt den Text für den Haftungsausschluss in der E-Mail an, welche die verschlüsselte Nachricht enthält. Die Höchstlänge beträgt 1024 Zeichen. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
Um vorhandenen Text zu entfernen und den Standardwert zu verwenden, verwenden Sie den Wert "$null" für diesen Parameter.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-EmailText
Anwendbar: Exchange Online, Exchange Online Protection
Der Parameter EmailText gibt den Standardtext an, der verschlüsselte E-Mail-Nachrichten begleitet. Der Standardtext wird über den Anweisungen zum Betrachten von verschlüsselten Nachrichten angezeigt. Die Höchstlänge beträgt 1024 Zeichen. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
Um vorhandenen Text zu entfernen und den Standardwert zu verwenden, verwenden Sie den Wert "$null" für diesen Parameter.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ExternalMailExpiryInDays
Anwendbar: Exchange Online
Dieser Parameter ist nur mit einem Microsoft 365 Advanced Message Encryption-Abonnement verfügbar.
Der Parameter "ExternalMailExpiryInDays" gibt an, für wie viele Tage die verschlüsselte Nachricht für externe Empfänger im Microsoft 365-Portal verfügbar ist. Bei einem gültigen Wert handelt es sich um eine Ganzzahl von 0 bis 730. Der Wert 0 bedeutet, dass die Nachrichten nie ablaufen. Der Standardwert ist 0.
Sie können den Wert dieses Parameters in der OME-Standardkonfiguration nicht aktualisieren. Sie können diesen Wert nur in einer benutzerdefinierten Konfiguration ändern.
In der Ausgabe des cmdlets Get-OMEConfiguration wird der Wert dieses Parameters in der ExternalMailExpiryInterval-Eigenschaft angezeigt.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Int32
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identity
Anwendbar: Exchange Online, Exchange Online Protection
Der Parameter Identity gibt die OME-Konfiguration an, die geändert werden soll. Die Standard-OME-Konfiguration hat den Identity-Wert „OME Configuration“.
Parametereigenschaften
| Typ: | OMEConfigurationIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Image
Anwendbar: Exchange Online, Exchange Online Protection
Der Parameter Image identifiziert und lädt ein Bild hoch, das in der E-Mail-Nachricht und im Microsoft 365 Admin Center angezeigt werden soll.
Ein gültiger Wert für diesen Parameter erfordert, dass Sie die Datei mithilfe der folgenden Syntax in ein bytecodiertes Objekt lesen: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Sie können diesen Befehl als Parameterwert verwenden, oder Sie können die Ausgabe in eine Variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) schreiben und die Variable als Parameterwert ($data) verwenden.
- Unterstützte Dateiformate: .png, .jpg, .bmp oder .tiff
- Optimale Größe der Logodatei: weniger als 40 KB
- Optimale Abmessungen des Logo-Bilds: 170 x 70 Pixel
Um ein vorhandenes Bild zu entfernen und das Standardbild zu verwenden, verwenden Sie den Wert "$null" für diesen Parameter.
Parametereigenschaften
| Typ: | Byte[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IntroductionText
Anwendbar: Exchange Online, Exchange Online Protection
Der Parameter "IntroductionText" gibt den Text an, der neben dem Namen und der E-Mail-Adresse des Absenders angezeigt wird. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
Um vorhandenen Text zu entfernen und den Standardwert zu verwenden, verwenden Sie den Wert "$null" für diesen Parameter.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-OTPEnabled
Anwendbar: Exchange Online, Exchange Online Protection
Der Parameter "OTPEnabled" gibt an, ob Empfänger einen einmaligen Zugangscode zum Anzeigen von verschlüsselten Nachrichten verwenden können. Gültige Werte sind:
- $true: Empfänger können einen einmaligen Zugangscode zum Anzeigen von verschlüsselten Nachrichten verwenden. Dieser Wert ist die Standardeinstellung.
- $false: Empfänger können keinen einmaligen Zugangscode zum Anzeigen von verschlüsselten Nachrichten verwenden. Der Empfänger muss sich mit einem Microsoft 365-Geschäfts-, Schul- oder Unikonto anmelden.
Parametereigenschaften
| Typ: | Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PortalText
Anwendbar: Exchange Online, Exchange Online Protection
Der Parameter "PortalText" gibt den Text an, der über dem Anzeigeportal für verschlüsselte Mail angezeigt wird. Die Höchstlänge beträgt 128 Zeichen. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
Um vorhandenen Text zu entfernen und den Standardwert zu verwenden, verwenden Sie den Wert "$null" für diesen Parameter.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PrivacyStatementUrl
Anwendbar: Exchange Online, Exchange Online Protection
Der Parameter „PrivacyStatementUrl“ führt den Link zu den Datenschutzbestimmungen in der verschlüsselten E-Mail-Benachrichtigung an.
Wenn Sie diesen Parameter nicht verwenden, leitet der Link für die Datenschutzbestimmungen standardmäßig zu den Microsoft-Datenschutzbestimmungen.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ReadButtonText
Anwendbar: Exchange Online, Exchange Online Protection
Der Parameter "ReadButtonText" führt den Text an, der auf der Schaltfläche "Meldung lesen" angezeigt wird. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
Um vorhandenen Text zu entfernen und den Standardwert zu verwenden, verwenden Sie den Wert "$null" für diesen Parameter.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SocialIdSignIn
Anwendbar: Exchange Online, Exchange Online Protection
Der Parameter SocialIdSignIn gibt an, ob ein Benutzer eine verschlüsselte Nachricht im Microsoft 365 Admin Center mit seiner eigenen social network ID (Google-, Yahoo- und Microsoft-Konto) anzeigen darf. Gültige Werte sind:
- $true: Die Anmeldung mit der ID des sozialen Netzwerks ist erlaubt. Dieser Wert ist die Standardeinstellung.
- $false: Die Anmeldung mit der ID des sozialen Netzwerks ist nicht erlaubt. Ob der Empfänger eine Einmalkennung oder sein Microsoft 365-Geschäfts-, Schul- oder Unikonto verwenden kann, wird durch den OTPEnabled-Parameter gesteuert.
Parametereigenschaften
| Typ: | Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: Exchange Online, Exchange Online Protection
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.
Eingaben
Input types
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.
Ausgaben
Output types
Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.