Set-EdgeSyncServiceConfig

模組:
Exchange PowerShell

內部部署 Exchange 才有提供此 Cmdlet。

使用 Set-EdgeSyncServiceConfig 指令程式來修改 Edge 同步處理服務設定的組態，這些設定會控制所有 EdgeSync 服務共用的一般同步處理行為。

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

語法

Default (預設值) 

Set-EdgeSyncServiceConfig
    [-Identity] <EdgeSyncServiceConfigIdParameter>
    [-ConfigurationSyncInterval <EnhancedTimeSpan>]
    [-Confirm]
    [-CookieValidDuration <EnhancedTimeSpan>]
    [-DomainController <Fqdn>]
    [-FailoverDCInterval <EnhancedTimeSpan>]
    [-LockDuration <EnhancedTimeSpan>]
    [-LockRenewalDuration <EnhancedTimeSpan>]
    [-LogEnabled <Boolean>]
    [-LogLevel <EdgeSyncLoggingLevel>]
    [-LogMaxAge <EnhancedTimeSpan>]
    [-LogMaxDirectorySize <Unlimited>]
    [-LogMaxFileSize <Unlimited>]
    [-LogPath <String>]
    [-Name <String>]
    [-OptionDuration <EnhancedTimeSpan>]
    [-RecipientSyncInterval <EnhancedTimeSpan>]
    [-WhatIf]
    [<CommonParameters>]

Description

您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Set-EdgeSyncServiceConfig "Primary EdgeSync Settings" -LogEnabled $true -LogLevel Medium -LogPath "\\Server01\EdgeSyncLog" -LogMaxFileSize 5MB -LogMaxAge 3

此範例使用下列值來設定名為主要 EdgeSync 設定的 Microsoft Exchange EdgeSync 服務設定：

啟用 EdgeSync 記錄並設定至中級詳細資料層級。

記錄檔會儲存在命名為 Server01 上的 EdgeSyncLog 共用。

個別記錄檔大小上限為 5 MB。

記錄檔會保留 3 天。

參數

-ConfigurationSyncInterval

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ConfigurationSyncInterval 參數會指定 Microsoft Exchange EdgeSync 服務同步設定資料的頻率。 此預設值為 3 分鐘。

若要指定值，請輸入時間範圍值：dd.hh:mm:ss，其中 dd = 天數、hh = 時數、mm = 分鐘數，而 ss = 秒數。

參數屬性

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

參數集

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

-Confirm

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。

  • 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
  • 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet，指定不帶值的 Confirm 參數會造成暫停，強制您在繼續之前先確認命令。

參數屬性

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

參數集

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

-CookieValidDuration

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

CookieValidDuration 參數會指定 Cookie 記錄的有效長度。 預設值是 21 天。

若要指定值，請輸入時間範圍值：dd.hh:mm:ss，其中 dd = 天數、hh = 時數、mm = 分鐘數，而 ss = 秒數。

參數屬性

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

參數集

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

-DomainController

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。

參數屬性

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

參數集

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

-FailoverDCInterval

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

FailoverDCInterval 參數會指定如果 EdgeSync 無法從 Active Directory 讀取設定資料，在容錯移轉到另一個網域控制站之前，要等待多久。 預設值為 5 分鐘。

若要指定值，請輸入時間範圍值：dd.hh:mm:ss，其中 dd = 天數、hh = 時數、mm = 分鐘數，而 ss = 秒數。

參數屬性

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

參數集

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

-Identity

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Identity 參數會指定您要設定的 Microsoft Exchange EdgeSync 服務名稱。

參數屬性

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

參數集

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

-LockDuration

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

LockDuration 參數會指定 Microsoft Exchange EdgeSync 服務執行個體可以維護同步權限的獨佔鎖定多久。 當 EdgeSync 服務對同步處理權限維持獨佔鎖定時，沒有任何其他 EdgeSync 服務可接管同步處理。 此預設值為 6 分鐘。

若要指定值，請輸入時間範圍值：dd.hh:mm:ss，其中 dd = 天數、hh = 時數、mm = 分鐘數，而 ss = 秒數。

參數屬性

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

參數集

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

-LockRenewalDuration

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

LockRenewalDuration 參數會指定 EdgeSync 服務可在獨佔鎖定到期前多久更新鎖定。 此預設值為 4 分鐘。

若要指定值，請輸入時間範圍值：dd.hh:mm:ss，其中 dd = 天數、hh = 時數、mm = 分鐘數，而 ss = 秒數。

參數屬性

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

參數集

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

-LogEnabled

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

LogEnabled 參數會指定啟用或停用 EdgeSyncLog。 這個參數的有效輸入是 $true 或 $false。 預設值為 $true。

參數屬性

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

參數集

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

-LogLevel

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

LogLevel 參數會指定 EdgeSync 記錄層級。 有效值為：

  • 無 (預設值)
  • 低
  • 中
  • 高

參數屬性

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

參數集

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

-LogMaxAge

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

LogMaxAge 參數會指定保留 EdgeSyncLog 檔案的最大天數。 比指定值舊的記錄檔會遭到覆寫。 預設值是 30 天。

若要指定值，請輸入時間範圍值：dd.hh:mm:ss，其中 dd = 天數、hh = 時數、mm = 分鐘數，而 ss = 秒數。

參數屬性

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

參數集

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

-LogMaxDirectorySize

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

LogMaxDirectorySize 會指定 EdgeSyncLog 目錄可用磁碟空間量的上限。 預設值為 250 MB。

有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。

  • B (位元組)
  • KB (千位元組)
  • MB (百萬位元組)
  • GB (十億位元組)
  • TB (兆位元組)

不完整的值通常被視為位元組，但較小的值可能會進位到最接近的千位元組。

LogMaxFileSize 參數的值必須小於或等於 LogMaxDirectorySize 參數的值。 這兩個參數的有效輸入範圍都是 1 到 9223372036854775807 個位元組。 如果輸入 unlimited 值，則不會限制 EdgeSyncLog 目錄的大小。

參數屬性

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

參數集

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

-LogMaxFileSize

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

LogMaxFileSize 參數會指定 EdgeSyncLog 檔案的記錄檔大小上限。 預設值為 10 MB。

有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。

  • B (位元組)
  • KB (千位元組)
  • MB (百萬位元組)
  • GB (十億位元組)
  • TB (兆位元組)

不完整的值通常被視為位元組，但較小的值可能會進位到最接近的千位元組。

LogMaxFileSize 參數的值必須小於或等於 LogMaxDirectorySize 參數的值。 這兩個參數的有效輸入範圍都是 1 到 9223372036854775807 個位元組。 如果輸入 unlimited 值，則不會限制 EdgeSyncLog 檔案的大小。

參數屬性

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

參數集

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

-LogPath

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

LogPath 參數會指定儲存 EdgeSyncLog 檔案的磁碟位置。 預設值為 TransportRoles\Logs\EdgeSync\。

參數屬性

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

參數集

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

-Name

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Name 參數會指定 EdgeSync 服務組態的唯一名稱。

參數屬性

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

參數集

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

-OptionDuration

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

OptionDuration 參數會指定 Microsoft Exchange EdgeSync 服務執行個體可以維護同步權限的選用鎖定多久。 當 EdgeSync 服務對同步處理權限維持選擇性鎖定時，如果其他 EdgeSync 服務是使用 Start-EdgeSynchronization 命令來啟動，便可在選擇性鎖定過期後接管同步處理。 此預設值為 30 分鐘。

若要指定值，請輸入時間範圍值：dd.hh:mm:ss，其中 dd = 天數、hh = 時數、mm = 分鐘數，而 ss = 秒數。

參數屬性

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

參數集

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

-RecipientSyncInterval

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

RecipientSyncInterval 參數會指定 Microsoft Exchange EdgeSync 服務從通用類別目錄同步收件者資料的頻率。 預設值為 5 分鐘。

若要指定值，請輸入時間範圍值：dd.hh:mm:ss，其中 dd = 天數、hh = 時數、mm = 分鐘數，而 ss = 秒數。

參數屬性

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

參數集

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

-WhatIf

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。

參數屬性

類型: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。

輸入

Input types

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

輸出

Output types

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