New-OMEConfiguration
Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.
Verwenden Sie das Cmdlet New-OMEConfiguration, um eine Microsoft Purview-Nachrichtenverschlüsselung-Konfiguration zu erstellen.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
New-OMEConfiguration
[-Identity] <OrganizationIdParameter>
[-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. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den 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
New-OMEConfiguration -Identity "Contoso Marketing" -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 wird eine neue OME-Konfiguration mit dem Namen "Contoso Marketing" mit den angegebenen Werten erstellt. Nicht verwendete Parameter erhalten die Standardwerte.
Parameter
-BackgroundColor
Der Parameter "BackgroundColor" legt die Hintergrundfarbe fest. Gültige Werte sind:
- Ein verfügbarer HTML-Hexadezimalfarbcodewert (hexadezimales Triplet) (z. B
0x000000. weiß). - Ein verfügbarer Textwert (z. B
yellow. ist 0x00FFFF00). - $null (leer). Dies ist der Standardwert.
Weitere Informationen finden Sie unter Hinzufügen der Marke Ihrer Organisation zu Ihren verschlüsselten Nachrichten.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Confirm
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DisclaimerText
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 (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EmailText
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 (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ExternalMailExpiryInDays
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.
In der Ausgabe des cmdlets Get-OMEConfiguration wird der Wert dieses Parameters in der ExternalMailExpiryInterval-Eigenschaft angezeigt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Identity
Der Parameter Identity gibt einen eindeutigen Namen für das OME-Konfigurationsobjekt an. Die Höchstlänge beträgt 64 Zeichen. Wenn der Wert Leerzeichen enthält, müssen Sie ihn in Anführungszeichen (") setzen.
| Type: | OrganizationIdParameter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Image
Der Parameter Image identifiziert und lädt ein Bild hoch, das in der E-Mail-Nachricht und im Microsoft 365 Admin Center angezeigt wird.
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
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IntroductionText
Der Parameter IntroductionText gibt den Standardtext an, der verschlüsselte E-Mail-Nachrichten begleitet. Der Standardtext wird unter der E-Mail-Adresse des Empfängers zum Anzeigen der verschlüsselten Nachricht angezeigt. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-OTPEnabled
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. Dies ist der Standardwert.
- $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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PortalText
Der Parameter PortalText gibt den Text an, der oben im Portal für die Anzeige verschlüsselter E-Mails angezeigt wird. Die Höchstlänge beträgt 128 Zeichen. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PrivacyStatementUrl
{{ Fill PrivacyStatementUrl Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ReadButtonText
Der Parameter "ReadButtonText" gibt den Text an, der auf der Schaltfläche "Read Message" angezeigt wird. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SocialIdSignIn
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 usw.) anzeigen darf. Gültige Werte sind:
- $true: Die Anmeldung mit der ID des sozialen Netzwerks ist erlaubt. Dies ist der Standardwert.
- $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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-WhatIf
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |