Set-ClientAccessServer

模組:

Exchange PowerShell

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

使用 Set-ClientAccessServer Cmdlet 修改與用戶端存取伺服器角色相關聯的設定。

注意：在 Exchange 2013 或更新版本中，請改用 Set-ClientAccessService Cmdlet。 如果您有使用 Set-ClientAccessServer 的指令碼，請將它們更新為使用 Set-ClientAccessService。

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

語法

AlternateServiceAccount

Set-ClientAccessServer
    [-Identity] <ClientAccessServerIdParameter>
    [-AlternateServiceAccountCredential <PSCredential[]>]
    [-CleanUpInvalidAlternateServiceAccountCredentials]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IrmLogEnabled <Boolean>]
    [-IrmLogMaxAge <EnhancedTimeSpan>]
    [-IrmLogMaxDirectorySize <Unlimited>]
    [-IrmLogMaxFileSize <ByteQuantifiedSize>]
    [-IrmLogPath <LocalLongFullPath>]
    [-IsOutOfService <Boolean>]
    [-RemoveAlternateServiceAccountCredentials]
    [-WhatIf]
    [<CommonParameters>]

Identity

Set-ClientAccessServer
    [-Identity] <ClientAccessServerIdParameter>
    [-Array <ClientAccessArrayIdParameter>]
    [-AutoDiscoverServiceInternalUri <Uri>]
    [-AutoDiscoverSiteScope <MultiValuedProperty>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IrmLogEnabled <Boolean>]
    [-IrmLogMaxAge <EnhancedTimeSpan>]
    [-IrmLogMaxDirectorySize <Unlimited>]
    [-IrmLogMaxFileSize <ByteQuantifiedSize>]
    [-IrmLogPath <LocalLongFullPath>]
    [-IsOutOfService <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Description

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

範例

範例 1

Set-ClientAccessServer -Identity "MBX-01" -AutoDiscoverServiceInternalUri "https://mbx01.contoso.com/autodiscover/autodiscover.xml" -AutoDiscoverSiteScope "Mail"

此範例會在名為 MBX-01 的伺服器上，在用戶端存取服務中設定名為 Mail 的 Active Directory 站台的內部自動探索 URL。

參數

-AlternateServiceAccountCredential

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

AlternateServiceAccountCredential 參數會指定備用服務帳戶使用者名稱和密碼，通常用於 Exchange Server 2010 共存環境中的 Kerberos 驗證。 您可以指定多個以逗號分隔的值。

此參數的值需要使用 Get-Credential Cmdlet。 若要暫停此命令並收到輸入認證的提示，請使用值 (Get-Credential)。 或者，在您執行此命令之前，將認證儲存在變數中 (例如，$cred = Get-Credential)，然後將變數名稱 ($cred) 用於此參數。 如需詳細資訊，請參閱 Get-Credential。

參數屬性

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

參數集

AlternateServiceAccount

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

-Array

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

將保留此參數供 Microsoft 內部使用。

參數屬性

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

參數集

Identity

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

-AutoDiscoverServiceInternalUri

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

AutoDiscoverServiceInternalUri 參數會指定自動探索服務的內部 URL。

參數屬性

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

參數集

Identity

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

-AutoDiscoverSiteScope

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

AutoDiscoverSiteScope 參數會指定自動探索服務具有授權的 Active Directory 站台。 使用內部 URL 連接到自動探索服務的用戶端，必須存在於指定的站台中。

若要查看可用的 Active Directory 網站，請使用 Get-ADSite Cmdlet。

若要指定多個值，請使用下列語法： Value1,Value2,...ValueN。 如果這些值包含空格或需要引號，請使用下列語法: "Value1","Value2",..."ValueN"。

參數屬性

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

參數集

Identity

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

-CleanUpInvalidAlternateServiceAccountCredentials

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

CleanUpInvalidAlternateServiceAccountCredentials 參數可指定是否要移除先前設定的不再有效的替代服務帳戶。 您不需要使用此參數指定值。

參數屬性

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

參數集

AlternateServiceAccount

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

-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

-Identity

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

Identity 參數會指定您要修改的伺服器。 您可以使用唯一識別伺服器的任何值。 例如：

• 名稱
• 辨別名稱 (DN)
• FQDN
• GUID

參數屬性

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

參數集

(All)

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

-IrmLogEnabled

適用：Exchange Server 2010

IrmLogEnabled 參數指定是否為資訊版權管理 (IRM) 啟用記錄。 有效的值為 $true 或 $false。 預設值為 $true。

參數屬性

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

參數集

(All)

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

-IrmLogMaxAge

適用：Exchange Server 2010

IrmLogMaxAge 參數會指定 IRM 記錄的存留期上限。 早於指定值的記錄會被刪除。

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

例如，若要指定 15 小時間隔，請輸入 15：00：00。 預設值為 30 天 (30.00：00：00) 。

參數屬性

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

參數集

(All)

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

-IrmLogMaxDirectorySize

適用：Exchange Server 2010

IrmLogMaxDirectorySize 參數會指定 IRM 記錄的目錄大小上限。 當達到目錄大小上限時，伺服器會先刪除舊的記錄檔。

有效值是最高 909.5 TB (999999999999999 個位元組) 的數值或 unlimited 值。 預設值為 250 MB (262144000 個位元組)。

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

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

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

參數屬性

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

參數集

(All)

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

-IrmLogMaxFileSize

適用：Exchange Server 2010

IrmLogMaxFileSize 參數會指定 IRM 記錄檔的大小上限。 此值不能大於 IrmLogMaxDirectorySize 參數值。

有效值是最多 4 GB (4294967296) 位元組的數字。 預設值為 10 MB (10485760 個位元組)。

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

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

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

此參數的值必須小於或等於 ReceiveProtocolLogMaxDirectorySize 參數的值。

參數屬性

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

參數集

(All)

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

-IrmLogPath

適用：Exchange Server 2010

IrmLogPath 參數會指定 IRM 記錄檔的位置。 預設位置是 %ExchangeInstallPath%Logging\IRMLogs。

如果將此參數的值設為 $null，則實際上會停用 IRM 記錄。 不過，如果 IrmLogEnabled 參數的值$true，Exchange 會將錯誤新增至應用程式事件記錄檔。 停用 IRM 記錄的慣用方式是將 IrmLogEnabled 參數設定為 $false。

參數屬性

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

參數集

(All)

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

-IsOutOfService

適用：Exchange Server 2010

將保留此參數供 Microsoft 內部使用。

參數屬性

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

參數集

(All)

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

-RemoveAlternateServiceAccountCredentials

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

RemoveAlternateServiceAccountCredentials 參數可指定是否要移除先前散發的替代服務帳戶。 您不需要使用此參數指定值。

參數屬性

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

參數集

AlternateServiceAccount

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

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