Set-OMEConfiguration
此 cmdlet 仅在基于云的服务中可用。
使用 Set-OMEConfiguration cmdlet 配置Microsoft Purview 邮件加密。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
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>]说明
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 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'))此示例为名为“OME 配置”的默认 OME 配置配置指定值。
参数
-BackgroundColor
BackgroundColor 参数指定背景色。 有效值包含:
- HTML 十六进制颜色代码值 (#RRGGBB) 用引号引起来。 例如，
"#FFFFFF"为白色。 - 有效的颜色名称值。 例如，
yellow是 #ffff00。 有关有效颜色名称的列表，请参阅 背景色参考。 - $null (空白) 。 此值为默认值。
| 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
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
| 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
DisclaimerText 参数指定包含加密邮件的电子邮件中的免责声明文本。 最大长度为 1024 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
若要删除现有文本并使用默认值，请对此参数使用值 $null。
| 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
EmailText 参数指定加密电子邮件附带的默认文本。 默认文本显示在说明的上方，以查看加密邮件。 最大长度为 1024 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
若要删除现有文本并使用默认值，请对此参数使用值 $null。
| 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
此参数仅适用于 Microsoft 365 高级消息加密订阅。
ExternalMailExpiryInDays 参数指定加密邮件在 Microsoft 365 门户中对外部收件人可用的天数。 有效值是 0 到 730 的整数。 值 0 表示消息永不过期。 默认值为 0。
无法在默认 OME 配置中更新此参数的值。 只能在自定义配置中修改此值。
在 Get-OMEConfiguration cmdlet 的输出中，此参数的值显示在 ExternalMailExpiryInterval 属性中。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Identity
Identity 参数指定您要修改的 OME 配置。 具有标识值“OME 配置”的默认 OME 配置。
| 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
Image 参数标识并上传将在电子邮件和Microsoft 365 管理中心中显示的图像。
此参数的有效值要求使用以下语法将文件读取到字节编码对象： ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))。 可以使用此命令作为参数值，也可以将输出写入变量 () $data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>') ，并将变量用作参数值 ($data) 。
- 支持的文件格式：.png、.jpg、.bmp 或 .tiff
- 徽标文件的最佳大小：小于 40 KB
- 徽标图像的最佳尺寸：170x70 像素
若要删除现有图片并使用默认图像，可使用此参数的 $null 值。
| 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
IntroductionText 参数指定发件人姓名和电子邮件地址旁边的文本。 如果值中有空格，请使用双引号 (") 将此值括起来。
若要删除现有文本并使用默认值，请对此参数使用值 $null。
| 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
OTPEnabled 参数指定是否允许收件人使用一次性密码来查看加密邮件。 有效值包含:
- $true：收件人可以使用一次性密码查看加密邮件。 此值为默认值。
- $false：收件人不能使用一次性密码查看加密邮件。 收件人需要使用 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
PortalText 参数指定将显示在加密邮件查看门户顶部的文本。 最大长度为 128 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
若要删除现有文本并使用默认值，请对此参数使用值 $null。
| 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
PrivacyStatementUrl 参数指定加密电子邮件通知消息中的隐私声明链接。
如果不使用此参数，隐私声明链接将转到默认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
ReadButtonText 参数指定在“阅读邮件”按钮上显示的文本。 如果值中有空格，请使用双引号 (") 将此值括起来。
若要删除现有文本并使用默认值，请对此参数使用值 $null。
| 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
SocialIdSignIn 参数指定是否允许用户使用 Google、Yahoo 和 Microsoft 帐户) 自己的社交网络 ID (在Microsoft 365 管理中心查看其自己的社交网络 ID。 有效值包含:
- $true：允许社交网络 ID 登录。 此值为默认值。
- $false：不允许登录社交网络 ID。 收件人是否可以使用一次性密码或其Microsoft 365 工作或学校帐户由 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
保留此参数以供 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 |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。