New-OMEConfiguration

模組:

Exchange PowerShell

此指令程式只能在雲端式服務中使用。

使用 New-OMEConfiguration Cmdlet 建立Microsoft Purview 郵件加密設定。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

語法

Default (預設值)

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>]

Description

您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 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

適用：Exchange Online

BackgroundColor 參數會指定背景色彩。 有效值為：

• 可用的 HTML 十六進位 (十六進位三元組) 色彩代碼值 (例如， 0x000000 白色) 。
• 例如， yellow 可用的文字值 (是 0x00FFFF00) 。
• $null (空白) 。 此值為預設值。

如需詳細資訊，請參閱將貴組織的品牌新增至您的加密郵件。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

適用：Exchange Online

將保留此參數供 Microsoft 內部使用。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	CF

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DisclaimerText

適用：Exchange Online

DisclaimerText 參數會指定含有已加密郵件之電子郵件中的免責聲明文字。 最大長度為 1024 個字元。 如果值包含空格，請使用引號 (") 括住值。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EmailText

適用：Exchange Online

EmailText 參數會指定伴隨加密電子郵件訊息的預設文字。 在檢視加密訊息的指示上顯示的預設文字。 最大長度為 1024 個字元。 如果值包含空格，請使用引號 (") 括住值。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ExternalMailExpiryInDays

適用：Exchange Online

此參數僅適用於 Microsoft 365 進階郵件加密訂閱。

ExternalMailExpiryInDays 參數會指定加密的郵件可供外部收件者在 Microsoft 365 入口網站中使用的天數。 有效值是從 0 到 730 的整數。 值 0 表示訊息永不過期。 預設值為 0。

在 Get-OMEConfiguration Cmdlet 的輸出中，此參數的值會顯示在 ExternalMailExpiryInterval 屬性中。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

Int32

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Identity

適用：Exchange Online

Identity 參數會指定 OME 組態物件的唯一名稱。 最大長度為 64 個字元。 如果值包含空格，請使用引號 (") 括住值。

參數屬性

類型:	OrganizationIdParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	0
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Image

適用：Exchange Online

Image 參數可識別並上傳電子郵件訊息和 Microsoft 365 系統管理中心中顯示的影像。

若要使用此參數的有效值，您必須使用下列語法將檔案讀取至位元組編碼物件： ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))。 您可以使用此命令作為參數值，也可以將輸出寫入變數 ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) ，然後使用該變數作為參數值 ($data) 。

• 支援的檔案格式：.png、.jpg、.bmp 或 .tiff
• 標誌檔案的最佳大小：小於 40 KB
• 標誌影像的最佳維度：170x70 像素

參數屬性

類型:	Byte[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IntroductionText

適用：Exchange Online

IntroductionText 參數會指定隨附加密電子郵件的預設文字。 預設文字會顯示在收件者電子郵件地址下方，用於檢視加密的郵件。 如果值包含空格，請使用引號 (") 括住值。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-OTPEnabled

適用：Exchange Online

OTPEnabled 參數會指定是否允許收件者使用一次性密碼檢視加密的郵件。 有效值為：

• $true：收件者可以使用一次性密碼來檢視加密的郵件。 此值為預設值。
• $false：收件者無法使用一次性密碼來檢視加密的郵件。 收件者必須使用 Microsoft 365 公司或學校帳戶登入。

參數屬性

類型:	Boolean
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PortalText

適用：Exchange Online

PortalText 參數會指定出現在加密電子郵件檢視入口網站頂端的文字。 最大長度為 128 個字元。 如果值包含空格，請使用引號 (") 括住值。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PrivacyStatementUrl

適用：Exchange Online

{{ Fill PrivacyStatementUrl 描述 }}

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ReadButtonText

適用：Exchange Online

ReadButtonText 參數會指定 [讀取訊息] 按鈕上顯示的文字。 如果值包含空格，請使用引號 (") 括住值。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SocialIdSignIn

適用：Exchange Online

SocialIdSignIn 參數會指定是否允許使用者使用自己的社交網路識別碼 (Google、Yahoo 等) ，在Microsoft 365 系統管理中心中檢視加密的訊息。 有效值為：

• $true：允許社交網路 ID 登入。 此值為預設值。
• $false：不允許社交網路 ID 登入。 收件者是否可以使用一次性密碼或其 Microsoft 365 公司或學校帳戶，是由 OTPEnabled 參數所控制。

參數屬性

類型:	Boolean
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

適用：Exchange Online

將保留此參數供 Microsoft 內部使用。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	WI

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。