Set-EdgeSyncServiceConfig
內部部署 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
此範例會使用下列值,設定名為 Primary EdgeSync Settings 的 Microsoft Exchange EdgeSync 服務設定:
啟用 EdgeSync 記錄並設定至中級詳細資料層級。
記錄檔會儲存在命名為 Server01 上的 EdgeSyncLog 共用。
個別記錄檔大小上限為 5 MB。
記錄檔會保留 3 天。
參數
-ConfigurationSyncInterval
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
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
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
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
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
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
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
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
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
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
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
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
LogMaxDirectorySize 會指定 EdgeSyncLog 目錄可用磁碟空間量的上限。 預設值為 250 MB。
有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。
- B (位元組)
- KB (千位元組)
- MB (百萬位元組)
- GB (十億位元組)
- TB (兆位元組)
非限定值通常會被視為位元組,但小型值可能會四捨五入到最接近的 KB。
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
LogMaxFileSize 參數會指定 EdgeSyncLog 檔案的記錄檔大小上限。 預設值為 10 MB。
有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。
- B (位元組)
- KB (千位元組)
- MB (百萬位元組)
- GB (十億位元組)
- TB (兆位元組)
非限定值通常會被視為位元組,但小型值可能會四捨五入到最接近的 KB。
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
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 年
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 年
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 年
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 年
WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。