共用方式為


Set-ClientAccessServer

內部部署 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

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

將保留此參數供 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

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

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

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

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

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

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

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

參數屬性

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

參數集

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

-IrmLogEnabled

適用:Exchange Server 2010 年

只有在 Exchange Server 2010 中才能使用此參數。

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

參數屬性

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

參數集

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

-IrmLogMaxAge

適用:Exchange Server 2010 年

只有在 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 年

只有在 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 (兆位元組)

非限定值通常會被視為位元組,但小型值可能會四捨五入到最接近的 KB。

參數屬性

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

參數集

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

-IrmLogMaxFileSize

適用:Exchange Server 2010 年

只有在 Exchange Server 2010 中才能使用此參數。

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

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

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

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

非限定值通常會被視為位元組,但小型值可能會四捨五入到最接近的 KB。

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

參數屬性

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

參數集

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

-IrmLogPath

適用:Exchange Server 2010 年

只有在 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 年

只有在 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

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

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

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