New-OMEConfiguration
此 cmdlet 仅在基于云的服务中可用。
使用 New-OMEConfiguration cmdlet 创建Microsoft Purview 邮件加密配置。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
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>]说明
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 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'))此示例使用指定的值创建名为“Contoso Marketing”的新 OME 配置。 未使用的参数获取默认值。
参数
-BackgroundColor
BackgroundColor 参数指定背景色。 有效值包含:
- 例如
0x000000，可用的 HTML 十六进制 (十六进制三元) 颜色代码值 (为白色) 。 - 例如，
yellow0x00FFFF00) 可用文本值 (。 - $null (空白) 。 此值为默认值。
有关详细信息，请参阅 将组织的品牌添加到加密邮件。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Confirm
保留此参数以供 Microsoft 内部使用。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DisclaimerText
DisclaimerText 参数指定包含加密邮件的电子邮件中的免责声明文本。 最大长度为 1024 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EmailText
EmailText 参数指定加密电子邮件附带的默认文本。 默认文本显示在说明的上方，以查看加密邮件。 最大长度为 1024 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ExternalMailExpiryInDays
此参数仅适用于 Microsoft 365 高级消息加密订阅。
ExternalMailExpiryInDays 参数指定加密邮件在 Microsoft 365 门户中对外部收件人可用的天数。 有效值是 0 到 730 的整数。 值 0 表示消息永不过期。 默认值为 0。
在 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 配置对象的唯一名称。 最大长度为 64 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
| Type: | OrganizationIdParameter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 像素
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IntroductionText
IntroductionText 参数指定加密电子邮件附带的默认文本。 默认文本显示在收件人电子邮件地址下方，用于查看加密邮件。 如果值中有空格，请使用双引号 (") 将此值括起来。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PortalText
PortalText 参数指定显示在加密电子邮件查看门户顶部的文本。 最大长度为 128 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PrivacyStatementUrl
{{ Fill PrivacyStatementUrl Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ReadButtonText
ReadButtonText 参数指定“读取消息”按钮上显示的文本。 如果值中有空格，请使用双引号 (") 将此值括起来。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 |