Set-OMEConfiguration

模組:

ExchangePowerShell

適用於:

Exchange Online, Exchange Online Protection

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

使用 Set-OMEConfiguration Cmdlet 來設定Microsoft Purview 郵件加密。

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

Syntax

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

Description

您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 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 Configuration"。

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 參數會指定是否允許使用者使用自己的社交網路識別碼檢視Microsoft 365 系統管理中心中的加密訊息， (Google、Yahoo 和 Microsoft 帳戶) 。 有效值為：

• $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, 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

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。