New-OMEConfiguration
此指令程式只能在雲端式服務中使用。
使用 New-OMEConfiguration Cmdlet 來建立Microsoft Purview 郵件加密組態。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
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 或參數所需的權限，請參閱 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 十六進位 (十六進位三進制) 色彩代碼值 (為白色) 。 - 例如
yellow， (可用的文字值為 0x00FFFF00) 。 - $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 參數會指定是否允許使用者使用自己的社交網路識別碼檢視Microsoft 365 系統管理中心中加密的訊息， (Google、Yahoo 等) 。 有效值為：
- $true：允許社交網路識別碼登入。 這是預設值。
- $false：不允許社交網路識別碼登入。 收件者是否可以使用一次性密碼，或其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 |