New-OMEConfiguration
Cette cmdlet est disponible uniquement dans le service cloud.
Utilisez l’applet de commande New-OMEConfiguration pour créer une configuration Chiffrement de messages Microsoft Purview.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
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>]
Description
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 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'))
Cet exemple crée une configuration OME nommée « Contoso Marketing » avec les valeurs spécifiées. Les paramètres inutilisés obtiennent les valeurs par défaut.
Paramètres
-BackgroundColor
Le paramètre BackgroundColor spécifie la couleur d’arrière-plan. Les valeurs valides sont les suivantes :
- Valeur de code de couleur hexadécimale HTML (triplet hexadécimal) disponible (par exemple,
0x000000
est blanc). - Valeur de texte disponible (par exemple,
yellow
est 0x00FFFF00). - $null (vide). Il s’agit de la valeur par défaut.
Pour plus d’informations, consultez la rubrique Ajouter la marque de votre organisation à vos messages chiffrés.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Confirm
Ce paramètre est réservé à l’usage interne chez Microsoft.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-DisclaimerText
Le paramètre DisclaimerText permet d’indiquer le texte de l’avertissement dans le courrier électronique qui contient le message chiffré. La longueur maximale est de 1 024 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-EmailText
Le paramètre EmailText spécifie le texte par défaut qui accompagne les messages électroniques chiffrés. Le texte par défaut s’affiche au-dessus des instructions relatives à l’affichage des messages chiffrés. La longueur maximale est de 1024 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ExternalMailExpiryInDays
Ce paramètre est disponible uniquement avec un abonnement Microsoft 365 Advanced Message Encryption.
Le paramètre ExternalMailExpiryInDays spécifie le nombre de jours pendant lesquels le message chiffré est disponible pour les destinataires externes dans le portail Microsoft 365. Une valeur valide est un entier compris entre 0 et 730. La valeur 0 signifie que les messages n’expireront jamais. La valeur par défaut est 0.
Dans la sortie de l’applet de commande Get-OMEConfiguration, la valeur de ce paramètre s’affiche dans la propriété ExternalMailExpiryInterval.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Identity
Le paramètre Identity spécifie un nom unique pour l’objet de configuration OME. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
Type: | OrganizationIdParameter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Image
Le paramètre Image identifie et charge une image qui sera affichée dans l’e-mail et dans le Centre d'administration Microsoft 365.
Une valeur valide pour ce paramètre vous oblige à lire le fichier dans un objet codé en octets à l’aide de la syntaxe suivante : ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))
. Vous pouvez utiliser cette commande comme valeur de paramètre, ou vous pouvez écrire la sortie dans une variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')
) et utiliser la variable comme valeur de paramètre ($data
).
- Formats de fichier pris en charge : .png, .jpg, .bmp ou .tiff
- Taille optimale de fichier de logo : moins de 40 ko
- Dimensions optimales de l’image de logo : 170x70 pixels
Type: | Byte[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-IntroductionText
Le paramètre IntroductionText spécifie le texte par défaut qui accompagne les messages électroniques chiffrés. Le texte par défaut apparaît sous l’adresse e-mail du destinataire pour afficher le message chiffré. Si la valeur contient des espaces, placez-la entre guillemets (").
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-OTPEnabled
Le paramètre OTPEnabled indique si les destinataires sont autorisés à utiliser un code secret à usage unique pour afficher les messages chiffrés. Les valeurs valides sont les suivantes :
- $true : les destinataires peuvent utiliser un code secret à usage unique pour afficher les messages chiffrés. Il s’agit de la valeur par défaut.
- $false : les destinataires ne peuvent pas utiliser de code secret à usage unique pour afficher les messages chiffrés. Le destinataire doit se connecter à l’aide d’un compte professionnel ou scolaire Microsoft 365.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-PortalText
Le paramètre PortalText spécifie le texte qui apparaît en haut du portail d’affichage des e-mails chiffrés. La longueur maximale est de 128 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
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
Le paramètre ReadButtonText spécifie le texte qui apparaît sur le bouton « Lire le message ». Si la valeur contient des espaces, placez-la entre guillemets (").
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-SocialIdSignIn
Le paramètre SocialIdSignIn spécifie si un utilisateur est autorisé à afficher un message chiffré dans le Centre d'administration Microsoft 365 à l’aide de son propre ID de réseau social (Google, Yahoo, etc.). Les valeurs valides sont les suivantes :
- $true : la connexion à l’ID de réseau social est autorisée. Il s’agit de la valeur par défaut.
- $false : la connexion à l’ID de réseau social n’est pas autorisée. Si le destinataire peut utiliser un code secret à usage unique ou son compte professionnel ou scolaire Microsoft 365 est contrôlé par le paramètre OTPEnabled.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-WhatIf
Ce paramètre est réservé à l’usage interne chez Microsoft.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |