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.
Syntaxe
Default (Par défaut)
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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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
Applicable : Exchange Online
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,
0x000000est blanc). - Valeur de texte disponible (par exemple,
yellowest 0x00FFFF00). - $null (vide). Cette valeur est la valeur par défaut.
Pour plus d’informations, consultez la rubrique Ajouter la marque de votre organisation à vos messages chiffrés.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : Exchange Online
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DisclaimerText
Applicable : Exchange Online
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 (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-EmailText
Applicable : Exchange Online
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 (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExternalMailExpiryInDays
Applicable : Exchange Online
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’expirent 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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Int32
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Online
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 (").
Propriétés du paramètre
| Type: | OrganizationIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Image
Applicable : Exchange Online
Le paramètre Image identifie et charge une image qui s’affiche dans le message électronique 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
Propriétés du paramètre
| Type: | Byte[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-IntroductionText
Applicable : Exchange Online
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 (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-OTPEnabled
Applicable : Exchange Online
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. Cette valeur est 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.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PortalText
Applicable : Exchange Online
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 (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PrivacyStatementUrl
Applicable : Exchange Online
{{ Fill PrivacyStatementUrl Description }}
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ReadButtonText
Applicable : Exchange Online
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 (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SocialIdSignIn
Applicable : Exchange Online
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. Cette valeur est 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.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Online
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.