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.
Syntax
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 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
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
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). Il s’agit de la valeur par défaut.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Confirm
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-*) ont 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.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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 (").
Pour supprimer le texte existant et utiliser la valeur par défaut, utilisez la valeur $null pour ce paramètre.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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 (").
Pour supprimer le texte existant et utiliser la valeur par défaut, utilisez la valeur $null pour ce paramètre.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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.
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.
| 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 la configuration OME à modifier. La configuration OME par défaut possède la valeur d’identité « OME Configuration ».
| Type: | OMEConfigurationIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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
Pour supprimer une image existante et utiliser l’image par défaut, utilisez la valeur $null pour ce paramètre.
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-IntroductionText
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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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, Exchange Online Protection |
-PortalText
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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-PrivacyStatementUrl
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é par défaut Microsoft.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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 (").
Pour supprimer le texte existant et utiliser la valeur par défaut, utilisez la valeur $null pour ce paramètre.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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 et Microsoft compte). 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, Exchange Online Protection |
-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, Exchange Online Protection |
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.