Set-OMEConfiguration

此 cmdlet 仅在基于云的服务中可用。

使用 Set-OMEConfiguration cmdlet 配置 Microsoft 365 邮件加密 (OME) 。

注意:建议使用 Exchange Online PowerShell V2 模块来连接到 Exchange Online PowerShell。 有关说明,请参阅连接 PowerShell Exchange Online

有关以下语法部分的参数设置的详细信息,请参阅 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 (Get-Content "C:\Temp\OME Logo.gif" -Encoding byte)

此示例为名为"OME 配置"的默认 OME 配置配置指定值。 请注意使用 Get-Content 命令可提供 Image 参数的输入。

参数

-BackgroundColor

BackgroundColor 参数指定背景色。 有效值为:

  • 用引号括起来 (#RRGGBB) HTML 十六进制颜色代码值。 例如, "#FFFFFF" 为白色。
  • 一个有效的颜色名称值。 例如 yellow ,#ffff00。 有关有效颜色名称的列表,请参阅 背景色参考
  • $null (空白) 。 此值为默认值。
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-Confirm

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet(例如,Remove-* cmdlet)内置有暂停,可强制要求你先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 其他大多数 cmdlet(例如,New-* and Set-*)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-DisclaimerText

DisclaimerText 参数指定包含加密邮件的电子邮件中的免责声明文本。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

若要删除现有文本并使用默认值,请对此参数使用值 $null。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-EmailText

EmailText 参数指定加密电子邮件附带的默认文本。 默认文本显示在说明的上方,以查看加密邮件。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

若要删除现有文本并使用默认值,请对此参数使用值 $null。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-ExternalMailExpiryInDays

此参数仅适用于 Microsoft 365 高级邮件加密订阅。

ExternalMailExpiryInDays 参数指定 Microsoft 365 门户中的外部收件人可以使用加密邮件的天数。 有效值是 0 到 730 的整数。 值 0 表示邮件永不过期。 默认值为 0。

不能更新默认 OME 配置中此参数的值。 只能在自定义配置中修改此值。

在 Get-OMEConfiguration cmdlet 的输出中,此参数的值显示在 ExternalMailExpiryInterval 属性中。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-Identity

Identity 参数指定您要修改的 OME 配置。 具有标识值“OME 配置”的默认 OME 配置。

Type:OMEConfigurationIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online
-Image

Image 参数标识并上载将在电子邮件和 Microsoft 365 管理中心中显示的图像。

您需要使用 Get-Content cmdlet 将文件读取到字节编码的对象,例如-Image (Get-Content "C: \ Temp \ OME Logo.gif" -Encoding byte)

  • 支持的文件格式:.png、.jpg、.bmp 或 .tiff
  • 徽标文件的最佳大小:小于 40 KB
  • 徽标图像的最佳尺寸:170x70 像素

若要删除现有图片并使用默认图像,可使用此参数的 $null 值。

Type:Byte[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-IntroductionText

IntroductionText 参数指定显示在发件人姓名和电子邮件地址旁边的文本。 如果值中有空格,请使用双引号 (") 将此值括起来。

若要删除现有文本并使用默认值,请对此参数使用值 $null。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-OTPEnabled

OTPEnabled 参数指定是否允许收件人使用一次性密码来查看加密邮件。 有效值为:

  • $true:收件人可以使用一次密码查看加密邮件。 此值为默认值。
  • $false:收件人无法使用一次密码查看加密邮件。 收件人需要使用 Microsoft 365 工作或学校帐户登录。
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-PortalText

PortalText 参数指定将显示在加密邮件查看门户顶部的文本。 最大长度为 128 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

若要删除现有文本并使用默认值,请对此参数使用值 $null。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-PrivacyStatementUrl

PrivacyStatementUrl 参数指定加密电子邮件通知邮件中的隐私声明链接。

如果不使用此参数,隐私声明链接将转到默认的 Microsoft 隐私声明。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-ReadButtonText

ReadButtonText 参数指定"读取邮件"按钮上显示的文本。 如果值中有空格,请使用双引号 (") 将此值括起来。

若要删除现有文本并使用默认值,请对此参数使用值 $null。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-SocialIdSignIn

SocialIdSignIn 参数指定是否允许用户使用自己的社交网络 ID(Google、Yahoo 等)在 Microsoft 365 管理中心 (加密) 。 有效值为:

  • $true:允许社交网络 ID 登录。 此值为默认值。
  • $false:不允许社交网络 ID 登录。 收件人是否可以使用一次密码或 Microsoft 365 工作或学校帐户由 OTPEnabled 参数控制。
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-WhatIf

保留此参数以供 Microsoft 内部使用。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

输入

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。