Set-OMEConfiguration
Cette cmdlet est disponible uniquement dans le service cloud.
Utilisez l’applet de commande Set-OMEConfiguration pour configurer 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)
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>]
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
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'))
Cet exemple configure les valeurs spécifiées pour la configuration OME par défaut nommée « Configuration OME ».
Paramètres
-BackgroundColor
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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 (#RRGGBB) placée entre guillemets. Par exemple,
"#FFFFFF"est blanc. - Valeur de nom de couleur valide. Par exemple,
yellowest #ffff00. Pour obtenir la liste des noms de couleurs valides, consultez Référence des couleurs d’arrière-plan. - $null (vide). Cette valeur est la valeur par défaut.
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, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false. - La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
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, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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 (").
Pour supprimer le texte existant et utiliser la valeur par défaut, utilisez la valeur $null pour ce paramètre.
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, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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 (").
Pour supprimer le texte existant et utiliser la valeur par défaut, utilisez la valeur $null pour ce paramètre.
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.
Vous ne pouvez pas mettre à jour la valeur de ce paramètre dans la configuration OME par défaut. Vous pouvez uniquement modifier cette valeur dans une configuration personnalisée.
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, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre Identity spécifie la configuration OME à modifier. La configuration OME par défaut possède la valeur d’identité « OME Configuration ».
Propriétés du paramètre
| Type: | OMEConfigurationIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Image
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre Image identifie et charge une image à afficher 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
Pour supprimer une image existante et utiliser l’image par défaut, utilisez la valeur $null pour ce paramètre.
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, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre IntroductionText spécifie le texte qui s’affiche en regard du nom et de l’adresse e-mail de l’expéditeur. Si la valeur contient des espaces, placez-la entre guillemets (").
Pour supprimer le texte existant et utiliser la valeur par défaut, utilisez la valeur $null pour ce paramètre.
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, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre PortalText permet d’indiquer le texte qui apparaît en haut du portail d’affichage des messages chiffrés. La longueur maximale est de 128 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
Pour supprimer le texte existant et utiliser la valeur par défaut, utilisez la valeur $null pour ce paramètre.
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, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre PrivacyStatementUrl spécifie le lien Déclaration de confidentialité dans le message de notification par e-mail chiffré.
Si vous n’utilisez pas ce paramètre, le lien Déclaration de confidentialité accède à la déclaration de confidentialité Microsoft par défaut.
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, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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 (").
Pour supprimer le texte existant et utiliser la valeur par défaut, utilisez la valeur $null pour ce paramètre.
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, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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 (Compte Google, Yahoo et Microsoft). 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, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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.
Entrées
Input types
Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.
Sorties
Output types
Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.