New-EdgeSyncServiceConfig
內部部署 Exchange 才有提供此 Cmdlet。
使用 New-EdgeSyncServiceConfig 命令程式,可建立 Edge 同步處理服務設定,以控制所有 EdgeSync 服務共用的一般同步處理行為。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
New-EdgeSyncServiceConfig
[-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>]
[-OptionDuration <EnhancedTimeSpan>]
[-RecipientSyncInterval <EnhancedTimeSpan>]
[-Site <AdSiteIdParameter>]
[-WhatIf]
[<CommonParameters>]
Description
您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
New-EdgeSyncServiceConfig -LogEnabled $true -LogPath "\\Server01\EdgeSyncLog" -LogMaxFileSize 5MB -LogMaxAge 3
本範例建立具有下列組態的 EdgeSync 服務設定:
- 已啟用 EdgeSync 記錄。
- 記錄檔會儲存在 Server01 上的 EdgeSyncLog 共用。
- 個別記錄檔大小上限為 5 MB。
- 記錄檔會保留 3 天。
參數
-ConfigurationSyncInterval
ConfigurationSyncInterval 參數會指定 EdgeSync 服務同步處理組態資料的頻率。 此預設值為 3 分鐘。
若要指定值,請將其輸入為時間範圍:dd.hh:mm:ss,其中 dd = days、hh = hours、mm = minutes 和 ss = seconds。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-CookieValidDuration
CookieValidDuration 參數會指定 Cookie 記錄的有效長度。 預設值是 21 天。
若要指定值,請將其輸入為時間範圍:dd.hh:mm:ss,其中 dd = days、hh = hours、mm = minutes 和 ss = seconds。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-FailoverDCInterval
FailoverDCInterval 參數會指定 EdgeSync 在容錯移轉至另一個網域控制站之前,如果無法從 Active Directory 讀取組態資料,會等待多久。 預設值為 5 分鐘。
若要指定值,請將其輸入為時間範圍:dd.hh:mm:ss,其中 dd = days、hh = hours、mm = minutes 和 ss = seconds。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LockDuration
LockDuration 參數會指定 EdgeSync 服務執行個體可對同步處理權限維持獨佔鎖定的時間長度。 當 EdgeSync 服務對同步處理權限維持獨佔鎖定時,沒有任何其他 EdgeSync 服務可接管同步處理。 此預設值為 6 分鐘。
若要指定值,請將其輸入為時間範圍:dd.hh:mm:ss,其中 dd = days、hh = hours、mm = minutes 和 ss = seconds。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LockRenewalDuration
LockRenewalDuration 參數會指定 EdgeSync 服務可在獨佔鎖定到期前多久更新鎖定。 此預設值為 4 分鐘。
若要指定值,請將其輸入為時間範圍:dd.hh:mm:ss,其中 dd = days、hh = hours、mm = minutes 和 ss = seconds。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LogEnabled
LogEnabled參數會啟用或禁用 EdgeSync 記錄。 這個參數的有效輸入是 $true 或 $false。 預設值為 $true。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LogLevel
LogLevel 參數會指定 EdgeSync 記錄層級。 有效值為:
- 無 (這是預設值)
- 低
- 中
- 高
Type: | EdgeSyncLoggingLevel |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LogMaxAge
LogMaxAge 參數會指定保留 EdgeSyncLog 檔案的最大天數。 比指定值舊的記錄檔會遭到覆寫。 預設值是 30 天。
若要指定值,請將其輸入為時間範圍:dd.hh:mm:ss,其中 dd = days、hh = hours、mm = minutes 和 ss = seconds。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LogMaxDirectorySize
LogMaxDirectorySize 參數會指定 EdgeSyncLog 目錄可使用的磁碟空間容量上限。 預設值為 250 MB。
有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。
- B (位元組)
- KB (千位元組)
- MB (百萬位元組)
- GB (十億位元組)
- TB (TB)
TB (TB)
LogMaxFileSize 參數的值必須小於或等於 LogMaxDirectorySize 參數的值。 這兩個參數的有效輸入範圍都是 1 到 9223372036854775807 個位元組。 如果輸入 unlimited 值,則不會限制 EdgeSyncLLog 目錄的大小。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LogMaxFileSize
LogMaxFileSize 參數會指定 EdgeSyncLog 檔案的記錄檔大小上限。 預設值為 10 MB。
有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。
- B (位元組)
- KB (千位元組)
- MB (百萬位元組)
- GB (十億位元組)
- TB (TB)
TB (TB)
LogMaxFileSize 參數的值必須小於或等於 LogMaxDirectorySize 參數的值。 這兩個參數的有效輸入範圍都是 1 到 9223372036854775807 個位元組。 如果輸入 unlimited 值,則不會限制 EdgeSyncLog 檔案的大小。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LogPath
LogPath 參數會指定 EdgeSyncLog 檔的預設位置。 預設值為 TransportRoles\Logs\EdgeSync\。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-OptionDuration
OptionDuration 參數會指定 EdgeSync 服務執行個體可對同步處理權限維持選擇性鎖定的時間長度。 當 EdgeSync 服務對同步處理權限維持選擇性鎖定時,如果其他 EdgeSync 服務是使用 Start-EdgeSynchronization 命令來啟動,便可在選擇性鎖定過期後接管同步處理。 此預設值為 30 分鐘。
若要指定值,請將其輸入為時間範圍:dd.hh:mm:ss,其中 dd = days、hh = hours、mm = minutes 和 ss = seconds。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RecipientSyncInterval
RecipientSyncInterval 參數會指定 EdgeSync 服務從通用類別目錄同步處理收件者資料的頻率。 預設值為 5 分鐘。
若要指定值,請將其輸入為時間範圍:dd.hh:mm:ss,其中 dd = days、hh = hours、mm = minutes 和 ss = seconds。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Site
Site 參數會指定 EdgeSync 用來同步處理設定和收件者資料的 Active Directory 月臺。
Type: | AdSiteIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。