共用方式為


關於Configuration Manager中的用戶端安裝參數和屬性

適用於:Configuration Manager (目前的分支)

使用 CCMSetup.exe 命令來安裝Configuration Manager用戶端。 如果您在命令列上提供用戶端安裝 參數 ,它們會修改安裝行為。 如果您在命令列上提供用戶端安裝 屬性 ,它們會修改已安裝用戶端代理程式的初始組態。

關於 CCMSetup.exe

CCMSetup.exe 命令會下載必要的檔案,以從管理點或來源位置安裝用戶端。 這些檔案可能包括:

  • 安裝用戶端軟體的 Windows Installer 套件 client.msi

  • 用戶端必要條件

  • 匯報和修正Configuration Manager用戶端

注意事項

您無法直接安裝 client.msi。

CCMSetup.exe 提供命令列 參數 來自訂安裝。 參數前面會加上斜線 () / ,通常是小寫。 必要時,您可以使用冒號 (:) 緊接在 值後面,指定參數的值。 如需詳細資訊, 請參閱CCMSetup.exe 命令列參數

您也可以在 CCMSetup.exe 命令列提供 屬性 ,以修改 client.msi 的行為。 依照慣例的屬性是大寫。 您可以使用等號指定屬性的值 (=) 緊接著值。 如需詳細資訊, 請參閱Client.msi 屬性

重要事項

在指定 client.msi 屬性之前,請先指定 CCMSetup 參數。

CCMSetup.exe 和支援的檔案位於月臺伺服器上Configuration Manager安裝資料夾的 Client 資料夾中。 Configuration Manager將此資料夾共用至網站共用下的網路。 例如,\\SiteServer\SMS_ABC\Client

在命令提示字元中,CCMSetup.exe 命令會使用下列格式:

CCMSetup.exe [<Ccmsetup parameters>] [<client.msi setup properties>]

例如:

CCMSetup.exe /mp:SMSMP01 /logon SMSSITECODE=S01 FSP=SMSFSP01

此範例會執行下列動作:

  • 指定名為 SMSMP01 的管理點,以要求發佈點清單以下載用戶端安裝檔案。

  • 指定如果電腦上已有用戶端版本,則應該停止安裝。

  • 指示 client.msi 將用戶端指派給月臺碼 S01。

  • 指示 client.msi 使用名為 SMSFP01 的後援狀態點。

提示

如果參數值有空格,請以引號括住它。

如果您擴充 Configuration Manager 的 Active Directory 架構,月臺會在 Active Directory 網域服務 中發佈許多用戶端安裝屬性。 Configuration Manager用戶端會自動讀取這些屬性。 如需詳細資訊,請參閱關於發佈至 Active Directory 網域服務 的用戶端安裝屬性

CCMSetup.exe 命令列參數

/?

顯示適用于 ccmsetup.exe 的可用命令列參數。

範例:ccmsetup.exe /?

/AllowMetered

使用此參數來控制用戶端在計量付費網路上的行為。 此參數不接受任何值。 當您允許 ccmsetup 在計量付費網路上進行用戶端通訊時,它會下載內容、向網站註冊,以及下載初始原則。 任何進一步的用戶端通訊都會遵循該原則的用戶端設定。 如需詳細資訊,請 參閱關於用戶端設定

如果您在現有的裝置上重新安裝用戶端,它會使用下列優先順序來判斷其設定:

  1. 現有的本機用戶端原則
  2. 儲存在 Windows 登錄中的最後一個命令列
  3. ccmsetup 命令列上的參數

/AlwaysExcludeUpgrade

此參數會指定當您啟用 自動用戶端升級時,用戶端是否會自動升級。

支援的值:

  • TRUE:用戶端不會自動升級
  • FALSE:用戶端會自動升級預設 ()

例如:

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

如需詳細資訊,請參閱 延伸互通性用戶端

注意事項

使用 /AlwaysExcludeUpgrade 參數時,自動升級仍會執行。 不過,當 CCMSetup 執行 以執行升級時,它會注意到 /AlwaysExcludeUpgrade 參數已設定,而且會在 ccmsetup.log中記錄下列這一行:

Client is stamped with /alwaysexcludeupgrade. Stop proceeding.

CCMSetup 接著會立即結束,而不會執行升級。

/BITSPriority

當裝置透過 HTTP 連線下載用戶端安裝檔案時,請使用此參數來指定下載優先順序。 指定下列其中一個可能值:

  • FOREGROUND

  • HIGH

  • NORMAL (預設)

  • LOW

範例:ccmsetup.exe /BITSPriority:HIGH

/config

此參數會指定列出用戶端安裝屬性的文字檔。

  • 如果 CCMSetup 是以服務方式執行,請將此檔案放在 CCMSetup 系統資料夾中: %Windir%\Ccmsetup

  • 如果您指定 /noservice 參數,請將此檔案放在與 CCMSetup.exe 相同的資料夾中。

範例:CCMSetup.exe /config:"configuration file name.txt"

若要提供正確的檔案格式,請使用月臺伺服器上Configuration Manager安裝目錄中 \bin\<platform> 資料夾中的mobileclienttemplate.tcf檔案。 此檔案有區段及其使用方式的相關批註。 在區段中 [Client Install] 指定用戶端安裝屬性,在下列文字後面: Install=INSTALL=ALL

範例 [Client Install] 區段專案: Install=INSTALL=ALL SMSSITECODE=ABC SMSCACHESIZE=100

/downloadtimeout

如果 CCMSetup 無法下載用戶端安裝檔案,此參數會指定以分鐘為單位的最大逾時。 在此逾時之後,CCMSetup 會停止嘗試下載安裝檔案。 預設值為 1440 分鐘, (一天) 。

/retry使用 參數來指定重試嘗試之間的間隔。

範例:ccmsetup.exe /downloadtimeout:100

/ExcludeFeatures

此參數會指定 CCMSetup.exe 不會安裝指定的功能。

範例: CCMSetup.exe /ExcludeFeatures:ClientUI 不會在用戶端上安裝軟體中心。

注意事項

ClientUI 是 參數唯一支援的 /ExcludeFeatures 值。

/forceinstall

指定 CCMSetup.exe 卸載任何現有的用戶端,並安裝新的用戶端。

/forcereboot

使用此參數可強制電腦在必要時重新開機,以完成安裝。 如果您未指定此參數,CCMSetup 會在需要重新開機時結束。 接著會在下次手動重新開機之後繼續執行。

範例:CCMSetup.exe /forcereboot

/logon

如果已安裝任何版本的用戶端,此參數會指定應該停止用戶端安裝。

範例:ccmsetup.exe /logon

/mp

指定管理點,讓用戶端用來尋找用戶端安裝檔案最接近的發佈點。 如果沒有發佈點,或電腦在四小時後無法從發佈點下載檔案,則會從指定的管理點下載檔案。

如需 ccmsetup 如何下載內容的詳細資訊,請參閱 界限群組 - 用戶端安裝。 如果您同時 /mp 使用 和 /source 參數,該文章也包含 ccmsetup 行為的詳細資料。

重要事項

此參數會指定電腦尋找下載來源的初始管理點,而且可以是任何月臺中的任何管理點。 它不會將用戶端 指派給 指定的管理點。

電腦會根據用戶端連線的月臺系統角色設定,透過 HTTP 或 HTTPS 連線下載檔案。 如果您進行設定,下載也可以使用 BITS 節流。 如果您只針對 HTTPS 用戶端連線設定所有發佈點和管理點,請確認用戶端電腦具有有效的用戶端憑證。

您可以使用 /mp 命令列參數來指定多個管理點。 如果電腦無法連線到第一個電腦,它會嘗試指定清單中的下一個。 當您指定多個管理點時,請以分號分隔值。

如果用戶端使用 HTTPS 連線到管理點,請指定 FQDN 而不是電腦名稱稱。 值必須符合管理點 PKI 憑證的 主體主體別名。 雖然Configuration Manager支援針對內部網路上的連線使用憑證中的電腦名稱稱,但建議使用 FQDN。

具有電腦名稱稱的範例: ccmsetup.exe /mp:SMSMP01

FQDN 的範例: ccmsetup.exe /mp:smsmp01.contoso.com

此參數也可以指定雲端管理閘道的 URL (CMG) 。 使用此 URL 在以網際網路為基礎的裝置上安裝用戶端。 若要取得此參數的值,請使用下列步驟:

  • 建立 CMG。 如需詳細資訊, 請參閱設定 CMG

  • 在使用中用戶端上,以系統管理員身分開啟Windows PowerShell命令提示字元。

  • 執行下列命令:

    (Get-WmiObject -Namespace Root\Ccm\LocationServices -Class SMS_ActiveMPCandidate | Where-Object {$_.Type -eq "Internet"}).MP
    
  • 附加 https:// 前置詞以搭配 /mp 參數使用。

當您使用雲端管理閘道 URL 時的範例: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

重要事項

為 參數指定雲端管理閘道 /mp 的 URL 時,它必須以 開頭 https://

注意事項

/mp 命令列參數不會指定安裝後Configuration Manager用戶端所使用的管理點。 若要指定Configuration Manager用戶端安裝後所使用的初始管理點,請使用SMSMP client.msi 屬性。 若要指定Configuration Manager用戶端安裝後要使用的管理點清單,請使用SMSMPLIST client.msi 屬性。

/NoCRLCheck

指定當用戶端透過 HTTPS 與 PKI 憑證進行通訊時,不應檢查 CRL () 的憑證撤銷清單。 當您未指定此參數時,用戶端會先檢查 CRL,再建立 HTTPS 連線。 如需用戶端 CRL 檢查的詳細資訊,請參閱 規劃 PKI 憑證撤銷

範例:CCMSetup.exe /UsePKICert /NoCRLCheck

/noservice

此參數會防止 CCMSetup 以服務身分執行,其預設會執行此動作。 當 CCMSetup 以服務方式執行時,它會在電腦的本機系統帳戶內容中執行。 此帳戶可能沒有足夠的許可權可存取安裝所需的網路資源。 使用 /noservice 時,CCMSetup.exe 在您用來啟動安裝的使用者帳戶內容中執行。

範例:ccmsetup.exe /noservice

/regtoken

使用此參數來提供大量註冊權杖。 以網際網路為基礎的裝置會透過雲端管理閘道 (CMG) ,在註冊程式中使用此權杖。 如需詳細資訊,請參閱 CMG 的權杖型驗證

當您使用此參數時,也包含下列參數和屬性:

下列範例命令列包含其他必要的安裝參數和屬性:

ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72186325152220500 CCMHOSTNAME=CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72186325152220500 SMSSITECODE=ABC SMSMP=https://mp1.contoso.com /regtoken:eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6Ik9Tbzh2Tmd5VldRUjlDYVh5T2lacHFlMDlXNCJ9.eyJTQ0NNVG9rZW5DYXRlZ29yeSI6IlN7Q01QcmVBdXRoVG9rZW4iLCJBdXRob3JpdHkiOiJTQ0NNIiwiTGljZW5zZSI6IlNDQ00iLCJUeXBlIjoiQnVsa1JlZ2lzdHJhdGlvbiIsIlRlbmFudElkIjoiQ0RDQzVFOTEtMEFERi00QTI0LTgyRDAtMTk2NjY3RjFDMDgxIiwiVW5pcXVlSWQiOiJkYjU5MWUzMy1wNmZkLTRjNWItODJmMy1iZjY3M2U1YmQwYTIiLCJpc3MiOiJ1cm46c2NjbTpvYXV0aDI6Y2RjYzVlOTEtMGFkZi00YTI0LTgyZDAtMTk2NjY3ZjFjMDgxIiwiYXVkIjoidXJuOnNjY206c2VydmljZSIsImV4cCI6MTU4MDQxNbUwNSwibmJmIjoxNTgwMTU2MzA1fQ.ZUJkxCX6lxHUZhMH_WhYXFm_tbXenEdpgnbIqI1h8hYIJw7xDk3wv625SCfNfsqxhAwRwJByfkXdVGgIpAcFshzArXUVPPvmiUGaxlbB83etUTQjrLIk-gvQQZiE5NSgJ63LCp5KtqFCZe8vlZxnOloErFIrebjFikxqAgwOO4i5ukJdl3KQ07YPRhwpuXmwxRf1vsiawXBvTMhy40SOeZ3mAyCRypQpQNa7NM3adCBwUtYKwHqiX3r1jQU0y57LvU_brBfLUL6JUpk3ri-LSpwPFarRXzZPJUu4-mQFIgrMmKCYbFk3AaEvvrJienfWSvFYLpIYA7lg-6EVYRcCAA

提示

如果 CCMSetup 傳回錯誤0x87d0027e,請嘗試從命令列移除 /mp 參數。

/retry

如果 CCMSetup.exe 無法下載安裝檔案,請使用此參數以分鐘為單位指定重試間隔。 CCMSetup 會繼續重試,直到達到 參數中 /downloadtimeout 指定的限制為止。

範例:ccmsetup.exe /retry:20

/service

指定 CCMSetup 應該以使用本機系統帳戶的服務執行。

提示

如果您使用腳本來搭配 參數執行 CCMSetup.exe /service ,CCMSetup.exe 在服務啟動後結束。 它可能無法正確地向腳本報告安裝詳細資料。

範例:ccmsetup.exe /service

/skipprereq

此參數指定 CCMSetup.exe 不會安裝指定的必要條件。 您可以輸入多個值。 使用分號字元 (;) 來分隔每個值。

範例:

  • CCMSetup.exe /skipprereq:filename.exe

  • CCMSetup.exe /skipprereq:filename1.exe;filename2.exe

如需用戶端必要條件的詳細資訊,請參閱 Windows 用戶端必要條件

/source

指定檔案下載位置。 使用本機或 UNC 路徑。 裝置會使用伺服器訊息區 (SMB) 通訊協定來下載檔案。 若要使用 /source ,用戶端安裝的 Windows 使用者帳戶需要位置的 取許可權。

如需 ccmsetup 如何下載內容的詳細資訊,請參閱 界限群組 - 用戶端安裝。 如果您同時 /mp 使用 和 /source 參數,該文章也包含 ccmsetup 行為的詳細資料。

提示

您可以在命令列中多次使用 /source 參數來指定替代下載位置。

範例:ccmsetup.exe /source:"\\server\share"

/uninstall

使用此參數卸載Configuration Manager用戶端。 如需詳細資訊,請 參閱卸載用戶端

範例:ccmsetup.exe /uninstall

注意事項

從 2111 版開始,當您卸載用戶端時,如果用戶端存在,它也會移除用戶端啟動程式,ccmsetup.msi。

/UsePKICert

指定此參數,讓用戶端使用 PKI 用戶端驗證憑證。 如果您未包含此參數,或用戶端找不到有效的憑證,它會篩選掉所有 HTTPS 管理點,包括雲端管理閘道 (CMG) 。 用戶端會使用具有自我簽署憑證的 HTTP 連線。

範例:CCMSetup.exe /UsePKICert

如果裝置使用Microsoft Entra識別碼進行用戶端驗證,而且也有 PKI 型用戶端驗證憑證,如果您使用包含此參數,用戶端將無法從雲端管理閘道取得Microsoft Entra上線資訊, (CMG) 。 對於使用Microsoft Entra驗證的用戶端,請勿指定此參數,但包含AADRESOURCEURIAADCLIENTAPPID屬性。

注意事項

在某些情況下,您不需要指定此參數,但仍會使用用戶端憑證。 例如,用戶端推入和軟體更新型用戶端安裝。 當您手動安裝用戶端,並搭配啟用 HTTPS 的管理點使用 參數時, /mp 請使用此參數。

此外,當您安裝僅限網際網路通訊的用戶端時,也請指定此參數。 搭配使用 CCMALWAYSINF=1 以網際網路為基礎的管理點屬性, (CCMHOSTNAME) 和月臺碼 (SMSSITECODE) 。 如需網際網路型用戶端管理的詳細資訊,請參 閱網際網路或不受信任樹系的用戶端通訊考慮

/IgnoreSkipUpgrade

指定此參數以手動升級排除的用戶端。 如需詳細資訊,請 參閱如何從升級排除用戶端

CCMSetup.exe 傳回碼

CCMSetup.exe 命令提供下列傳回碼。 若要進行疑難排解,請檢閱 %WinDir%\ccmsetup\Logs\ccmsetup.log 用戶端上的內容和傳回碼的其他詳細資料。

傳回碼 意義
0 成功
6 錯誤
7 需要重新開機
8 安裝程式已在執行中
9 必要條件評估失敗
10 安裝程式資訊清單雜湊驗證失敗

Ccmsetup.msi 屬性

下列屬性可以修改 ccmsetup.msi 的安裝行為。

CCMSETUPCMD

使用此 ccmsetup。msi 屬性,可將其他命令列參數和屬性傳遞至 ccmsetup。exe。 在引號內包含其他參數和屬性 () " 。 當您使用Intune MDM 安裝方法啟動Configuration Manager用戶端時,請使用此屬性。

範例:ccmsetup.msi CCMSETUPCMD="/mp:https://mp.contoso.com CCMHOSTNAME=mp.contoso.com"

提示

Microsoft Intune會將命令列限制為 1024 個字元。

Client.msi 屬性

下列屬性可以修改 ccmsetup.exe 安裝之 client.msi 的安裝行為。

AADCLIENTAPPID

指定Microsoft Entra用戶端應用程式識別碼。 當您設定雲端管理的 Azure 服務 時,會建立或匯入用戶端應用程式。 Azure 系統管理員可以從Azure 入口網站取得此屬性的值。 如需詳細資訊,請參閱 取得應用程式識別碼。 針對 屬性 AADCLIENTAPPID ,此應用程式識別碼適用于 原生 應用程式類型。

範例:ccmsetup.exe AADCLIENTAPPID=aa28e7f1-b88a-43cd-a2e3-f88b257c863b

AADRESOURCEURI

指定Microsoft Entra伺服器應用程式識別碼。 當您設定雲端管理的 Azure 服務 時,會建立或匯入伺服器應用程式。 當您建立伺服器應用程式時,在 [建立伺服器應用程式] 視窗中,此屬性是 [應用程式識別碼 URI]

Azure 系統管理員可以從Azure 入口網站取得此屬性的值。 在[Microsoft Entra標識符] 中,尋找[應用程式註冊] 底下的伺服器應用程式。 尋找應用程式類型 Web 應用程式/API。 開啟應用程式,選取 [ 設定],然後選取 [ 屬性]。 使用此 AADRESOURCEURI 用戶端安裝屬性的應用程式識別碼 URI值。

範例:ccmsetup.exe AADRESOURCEURI=https://contososerver

AADTENANTID

指定Microsoft Entra租使用者識別碼。 當您設定雲端管理的Azure 服務時,Configuration Manager此租使用者的連結。 若要取得此屬性的值,請使用下列步驟:

  • 在執行Windows 10或更新版本並加入相同Microsoft Entra租使用者的裝置上,開啟命令提示字元。

  • 執行下列命令:dsregcmd.exe /status

  • 在 [裝置狀態] 區段中,尋找 TenantId 值。 例如,TenantId : 607b7853-6f6f-4d5d-b3d4-811c33fdd49a

    注意事項

    Azure 系統管理員也可以在Azure 入口網站中取得此值。 如需詳細資訊,請參閱 取得租使用者識別碼

範例:ccmsetup.exe AADTENANTID=607b7853-6f6f-4d5d-b3d4-811c33fdd49a

CCMADMINS

指定要授與用戶端設定和原則存取權的一或多個 Windows 使用者帳戶或群組。 當您在用戶端電腦上沒有本機系統管理認證時,這個屬性會很有用。 指定以分號分隔的帳戶清單 () ;

範例:CCMSetup.exe CCMADMINS="domain\account1;domain\group1"

CCMALLOWSILENTREBOOT

如有必要,允許電腦在用戶端安裝之後以無訊息方式重新開機。

重要事項

當您使用此屬性時,電腦會重新開機,而不會出現警告。 即使使用者已登入 Windows,也會發生此行為。

範例:CCMSetup.exe CCMALLOWSILENTREBOOT

CCMALWAYSINF

若要指定用戶端一律以網際網路為基礎,且永遠不會連線到內部網路,請將此屬性值設定為 1 。 用戶端的連線類型會顯示 Always Internet

使用此屬性搭配 CCMHOSTNAME 來指定以網際網路為基礎的管理點的 FQDN。 同時搭配 CCMSetup 參數 UsePKICertSMSSITECODE 屬性使用。

如需網際網路型用戶端管理的詳細資訊,請參 閱網際網路或不受信任樹系的用戶端通訊考慮

範例:CCMSetup.exe /UsePKICert CCMALWAYSINF=1 CCMHOSTNAME=SERVER3.CONTOSO.COM SMSSITECODE=ABC

CCMCERTISSUERS

使用此屬性來指定憑證簽發者清單。 此清單包含受信任根憑證授權單位的憑證資訊, (CA) Configuration Manager月臺信任。

此值是根 CA 憑證中主體屬性的區分大小寫比對。 以逗號 () 或分號 (,) ; 分隔屬性。 使用分隔符號列 () | 指定多個根 CA 憑證。

範例:CCMCERTISSUERS="CN=Contoso Root CA; OU=Servers; O=Contoso, Ltd; C=US | CN=Litware Corporate Root CA; O=Litware, Inc."

提示

在月臺的mobileclient.tcf檔案中,使用CertificateIssuers屬性的值。 此檔案位於 \bin\<platform> 月臺伺服器上Configuration Manager安裝目錄的子資料夾中。

如需憑證簽發者清單的詳細資訊,以及用戶端在憑證選取程式期間的使用方式,請參閱 規劃 PKI 用戶端憑證選取

CCMCERTNAMECHECK

從 2207 版開始,此屬性可用來略過檢查憑證的主體名稱。 CCMCERTNAMECHECK=0 會略過檢查憑證的主體名稱。

CCMCERTSEL

如果用戶端有多個憑證可進行 HTTPS 通訊,則此屬性會指定其選取有效用戶端驗證憑證的準則。

使用下列關鍵字來搜尋憑證主體名稱或主體別名:

  • Subject:尋找完全相符專案
  • SubjectStr:尋找部分相符專案

範例:

  • CCMCERTSEL="Subject:computer1.contoso.com":搜尋與主體名稱或主體別名中電腦名稱稱 computer1.contoso.com 完全相符的憑證。

  • CCMCERTSEL="SubjectStr:contoso.com":搜尋主體名稱或主體別名中包含 contoso.com 的憑證。

SubjectAttr使用 關鍵字來搜尋物件識別碼 (OID) 或主體別名中的辨別名稱屬性。

範例:

  • CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers":搜尋以物件識別碼表示且名為 的 Computers 組織單位屬性。

  • CCMCERTSEL="SubjectAttr:OU = Computers":搜尋以辨別名稱表示且名為 的 Computers 組織單位屬性。

重要事項

如果您使用主體名稱,關鍵 Subject 詞會區分大小寫,而且 SubjectStr 關鍵字不區分大小寫。

如果您使用主體別名, Subject 則 和 SubjectStr 關鍵字都不區分大小寫。

如需可用於憑證選取的完整屬性清單,請參閱 PKI 憑證選取準則的支援屬性值

如果有多個憑證符合搜尋,而且您將 設定為 CCMFIRSTCERT1 ,則用戶端安裝程式會選取有效期間最長的憑證。

CCMCERTSTORE

如果用戶端安裝程式在電腦的預設 個人 憑證存放區中找不到有效的憑證,請使用此屬性來指定替代憑證存放區名稱。

範例:CCMSetup.exe /UsePKICert CCMCERTSTORE="ConfigMgr"

CCMDEBUGLOGGING

此屬性可在用戶端安裝時啟用偵錯記錄。 此屬性會導致用戶端記錄低階資訊以進行疑難排解。 避免在生產網站中使用此屬性。 可能會發生過多的記錄,這可能會讓您難以在記錄檔中找到相關資訊。 也請啟用 CCMENABLELOGGING

支援的值:

  • 0:關閉偵錯記錄 (預設)
  • 1:開啟偵錯記錄

範例:CCMSetup.exe CCMDEBUGLOGGING=1

如需詳細資訊,請 參閱關於記錄檔

CCMENABLELOGGING

Configuration Manager預設會啟用記錄。

支援的值:

  • TRUE:開啟記錄 (預設)
  • FALSE:關閉記錄

範例:CCMSetup.exe CCMENABLELOGGING=TRUE

如需詳細資訊,請 參閱關於記錄檔

CCMEVALINTERVAL

用戶端健康情況評估工具 (ccmeval.exe) 執行的頻率,以分鐘為單位。 指定從 11440 的整數值。 根據預設,ccmeval (1440 分鐘) 一天執行一次。

範例:CCMSetup.exe CCMEVALINTERVAL=1440

如需用戶端健康情況評估的詳細資訊,請 參閱監視用戶端

CCMEVALHOUR

用戶端健康情況評估工具 (ccmeval.exe) 執行期間的小時。 指定從 0 午夜 () 到 23 下午 11:00 () 的整數值。 根據預設,ccmeval 會在午夜執行。

如需用戶端健康情況評估的詳細資訊,請 參閱監視用戶端

CCMFIRSTCERT

如果您將此屬性設定為 1 ,用戶端會選取有效期間最長的 PKI 憑證。

範例:CCMSetup.exe /UsePKICert CCMFIRSTCERT=1

CCMHOSTNAME

如果用戶端是透過網際網路管理,這個屬性會指定以網際網路為基礎的管理點的 FQDN。

請勿使用 的 SMSSITECODE=AUTO 安裝屬性來指定此選項。 直接將以網際網路為基礎的用戶端指派給以網際網路為基礎的網站。

範例:CCMSetup.exe /UsePKICert CCMHOSTNAME="SMSMP01.corp.contoso.com"

此屬性可以指定雲端管理閘道的位址 (CMG) 。 若要取得此屬性的值,請使用下列步驟:

  • 建立 CMG。 如需詳細資訊, 請參閱設定 CMG

  • 在使用中用戶端上,以系統管理員身分開啟Windows PowerShell命令提示字元。

  • 執行下列命令:

    (Get-WmiObject -Namespace Root\Ccm\LocationServices -Class SMS_ActiveMPCandidate | Where-Object {$_.Type -eq "Internet"}).MP
    
  • 將傳回的值與 屬性一起 CCMHOSTNAME 使用。

例如:ccmsetup.exe CCMHOSTNAME=CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

重要事項

當您指定 CCMHOSTNAME 屬性的 CMG 位址時,請勿附加前置詞,例如 https:// 。 只使用這個前置詞搭配 /mp CMG 的 URL。

CCMHTTPPORT

指定用戶端透過 HTTP 與月臺系統伺服器通訊時所要使用的埠。 根據預設,此值為 80

範例:CCMSetup.exe CCMHTTPPORT=80

CCMHTTPSPORT

指定用戶端透過 HTTPS 與月臺系統伺服器通訊時所要使用的埠。 根據預設,此值為 443

範例:CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIR

使用此屬性來設定資料夾,以安裝Configuration Manager用戶端檔案。 根據預設,它會使用 %WinDir%\CCM

提示

無論您在何處安裝用戶端檔案,它一律會在 資料夾中 %WinDir%\System32 安裝ccmcore.dll檔案。 在 64 位 OS 上,它會在 資料夾中 %WinDir%\SysWOW64 安裝 ccmcore.dll 複本。 此檔案支援使用來自 Configuration Manager SDK 之 32 位版本用戶端 API 的 32 位應用程式。

範例:CCMSetup.exe CCMINSTALLDIR="C:\ConfigMgr"

CCMLOGLEVEL

使用此屬性可指定要寫入記錄檔Configuration Manager詳細資料層級。

支援的值:

  • 0:詳細
  • 1:預設
  • 2:警告和錯誤
  • 3:僅錯誤

範例:CCMSetup.exe CCMLOGLEVEL=0

如需詳細資訊,請 參閱關於記錄檔

CCMLOGMAXHISTORY

當Configuration Manager記錄檔達到大小上限時,用戶端會將它重新命名為備份,並建立新的記錄檔。 這個屬性會指定要保留多少個舊版的記錄檔。 預設值為 1。 如果您將值設定為 0 ,則用戶端不會保留任何記錄檔記錄。

範例:CCMSetup.exe CCMLOGMAXHISTORY=5

如需詳細資訊,請 參閱關於記錄檔

CCMLOGMAXSIZE

這個屬性會指定記錄檔大小上限,以位元組為單位。 當記錄檔成長至指定的大小時,用戶端會將它重新命名為記錄檔,並建立新的記錄檔。 預設大小為 250,000 個位元組,大小下限為 10,000 個位元組。

範例: CCMSetup.exe CCMLOGMAXSIZE=300000 (300,000 個位元組)

DISABLESITEOPT

將此屬性設定為 , TRUE 以封鎖系統管理員在Configuration Manager控制台中變更指派的網站。

範例:CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPT

如果設定為 TRUE,這個屬性會停用系統管理使用者在[Configuration Manager控制台中變更用戶端快取資料夾設定的能力。

範例:CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIX

為用戶端指定 DNS 網域,以找出您在 DNS 中發佈的管理點。 當用戶端找到管理點時,它會告知用戶端階層中的其他管理點。 此行為表示用戶端從 DNS 找到的管理點可以是階層中的任何管理點。

注意事項

如果用戶端位於與已發佈管理點相同的網域中,則不需要指定此屬性。 在此情況下,會自動使用用戶端的網域來搜尋管理點的 DNS。

如需有關將 DNS 發佈為Configuration Manager用戶端之服務位置方法的詳細資訊,請參閱服務位置和用戶端如何判斷其指派的管理點

注意事項

根據預設,Configuration Manager不會啟用 DNS 發佈。

範例:CCMSetup.exe SMSSITECODE=ABC DNSSUFFIX=contoso.com

FSP

指定接收和處理Configuration Manager用戶端所傳送之狀態訊息的後援狀態點。

如需詳細資訊,請 參閱判斷您是否需要後援狀態點

範例:CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

如果您將此屬性設定為 TRUE ,用戶端安裝程式不會檢查 Microsoft Application Virtualization (App-V) 的最低必要版本。

重要事項

如果您在未安裝 App-V 的情況下安裝Configuration Manager用戶端,則無法部署虛擬應用程式

範例:CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

MANAGEDINSTALLER

如果您將此屬性設定為 1 ,則會將 ccmsetup.exe 和 client.msi 設定為受管理的安裝程式。 如需詳細資訊,請參閱使用Windows Defender 應用程式控制自動允許受管理安裝程式部署的應用程式

範例:CCMSetup.exe MANAGEDINSTALLER=1

NOTIFYONLY

當您啟用此屬性時,用戶端會報告狀態,但不會補救它找到的問題。

範例:CCMSetup.exe NOTIFYONLY=TRUE

如需詳細資訊,請參閱 如何設定用戶端狀態

PROVISIONTS

在用戶端成功向月臺註冊之後,請使用此屬性在用戶端上啟動工作順序。

注意事項

如果工作順序安裝軟體更新或應用程式,用戶端需要有效的用戶端驗證憑證。 僅權杖驗證無法運作。

例如,您使用 Windows Autopilot 布建新的 Windows 裝置、自動註冊它以Microsoft Intune,然後安裝Configuration Manager用戶端以進行共同管理。 如果您指定這個新選項,則新布建的用戶端會執行工作順序。 此程式可讓您額外彈性地安裝應用程式和軟體更新,或設定設定。

使用下列程式:

  1. 建立非 OS 部署工作順序 ,以安裝應用程式、安裝軟體更新,以及設定設定。

  2. 將此工作順序部署 至新的內建集合[ 所有布建裝置]。 請注意工作順序部署識別碼,例如 PRI20001

    提示

    部署的目的可以是可用或必要。 由於您將部署識別碼指定為屬性值,因此目的並不重要。

  3. 使用ccmsetup.msi在裝置上安裝Configuration Manager客戶端,並包含下列屬性: PROVISIONTS=PRI20001 。 將此屬性的值設定為工作順序部署識別碼。

    • 如果您要在共同管理註冊期間從 Intune 安裝用戶端,請參閱 如何準備以網際網路為基礎的裝置以進行共同管理

      注意事項

      此方法可能有其他必要條件。 例如,註冊網站以Microsoft Entra識別碼,或建立已啟用內容的雲端管理閘道。

      不論方法為何,請只將這個屬性與 ccmsetup.msi搭配使用。

在用戶端安裝並正確向月臺註冊之後,它會啟動參考的工作順序。 如果用戶端註冊失敗,工作順序將不會啟動。

注意事項

PROVISIONTS 啟動的工作順序會使用 預設用戶端設定。 此工作順序會在用戶端註冊之後立即啟動,因此不會是您已部署自訂用戶端設定之任何集合的一部分。 此工作循序執行之前,用戶端不會處理或套用自訂用戶端設定。

若要讓工作順序正常運作,您可能需要變更 [預設客戶端設定] 中的特定設定。 例如:

  • 雲端服務群組:讓用戶端能夠使用雲端管理閘道允許存取雲端發佈點
  • 電腦代理程式 群組: PowerShell 執行原則

如果裝置在工作順序完成後不需要這些用戶端設定,請部署新的自訂用戶端設定來反轉預設設定。

如需詳細資訊,請 參閱關於用戶端設定

RESETKEYINFORMATION

如果用戶端的受根信任金鑰Configuration Manager錯誤,則無法連絡信任的管理點以接收新的受根信任金鑰。 使用此屬性移除舊的受根信任金鑰。 當您將用戶端從一個月臺階層移至另一個月臺階層時,可能會發生這種情況。 此屬性適用于使用 HTTP 和 HTTPS 用戶端通訊的用戶端。 如需詳細資訊,請參閱 規劃受信任的根金鑰

範例:CCMSetup.exe RESETKEYINFORMATION=TRUE

SITEREASSIGN

搭配 SMSSITECODE=AUTO使用時,啟用用戶端升級的自動月臺重新指派。

範例:CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE

SMSCACHEDIR

指定用戶端電腦上用戶端快取資料夾的位置。 根據預設,快取位置為 %WinDir%\ccmcache

範例:CCMSetup.exe SMSCACHEDIR="C:\Temp"

使用此屬性搭配 SMSCACHEFLAGS 屬性來控制用戶端快取資料夾位置。 例如,若要在最大的可用用戶端磁片磁碟機上安裝用戶端快取資料夾: CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVE

SMSCACHEFLAGS

使用此屬性可指定用戶端快取資料夾的進一步安裝詳細資料。 您可以個別使用 SMSCACHEFLAGS 屬性,或以分號分隔屬性, (;) 。

如果您未包含此屬性:

  • 用戶端會根據 SMSCACHEDIR 屬性安裝快取資料夾
  • 資料夾未壓縮
  • 用戶端會使用 SMSCACHESIZE 屬性做為快取 MB 的大小限制

當您升級現有的用戶端時,用戶端安裝程式會忽略此屬性。

屬性的 SMSCACHEFLAGS

  • PERCENTDISKSPACE:將快取大小設定為 磁片總 空間的百分比。 如果您指定這個屬性,也請將 設定 SMSCACHESIZE 為百分比值。

  • PERCENTFREEDISKSPACE:將快取大小設定為 可用 磁碟空間的百分比。 如果您指定這個屬性,也請將 設定 SMSCACHESIZE 為百分比值。 例如,磁片有 10 MB 可用,而您指定 SMSCACHESIZE=50 。 用戶端安裝程式會將快取大小設定為 5 MB。 您無法將此屬性與 PERCENTDISKSPACE 屬性搭配使用。

  • MAXDRIVE:在最大的可用磁片上安裝快取。 如果您使用 屬性指定路徑 SMSCACHEDIR ,用戶端安裝程式會忽略此值。

  • MAXDRIVESPACE:在具有最多可用空間的磁片磁碟機上安裝快取。 如果您使用 屬性指定路徑 SMSCACHEDIR ,用戶端安裝程式會忽略此值。

  • NTFSONLY:僅在 NTFS 格式的磁片磁碟機上安裝快取。 如果您使用 屬性指定路徑 SMSCACHEDIR ,用戶端安裝程式會忽略此值。

  • COMPRESS:以壓縮格式儲存快取。

  • FAILIFNOSPACE:如果空間不足而無法安裝快取,請移除Configuration Manager用戶端。

範例:CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZE

重要事項

用戶端設定可用於指定用戶端快取資料夾大小。 新增這些用戶端設定可有效地取代使用 SMSCACHESIZE 作為 client.msi 屬性來指定用戶端快取的大小。 如需詳細資訊,請參閱 快取大小的用戶端設定

當您升級現有的用戶端時,用戶端安裝程式會忽略此設定。 用戶端在下載軟體更新時也會忽略快取大小。

範例:CCMSetup.exe SMSCACHESIZE=100

注意事項

如果您重新安裝用戶端,則無法使用 SMSCACHESIZESMSCACHEFLAGS ,將快取大小設定為小於先前的大小。 先前的大小是最小值。

SMSCONFIGSOURCE

使用此屬性來指定用戶端安裝程式檢查組態設定的位置和順序。 它是一或多個字元的字串,每個字元都會定義特定的組態來源:

  • R:檢查登錄中的組態設定。

    如需詳細資訊,請 參閱布建用戶端安裝屬性

  • P:從命令列檢查安裝內容中的組態設定。

  • M:當您升級較舊的用戶端時,請檢查現有的設定。

  • U:將已安裝的用戶端升級至較新的版本,並使用指派的月臺碼。

根據預設,用戶端安裝程式會使用 PU 。 它會先檢查安裝內容 (P) ,然後檢查現有的設定 (U) 。

範例:CCMSetup.exe SMSCONFIGSOURCE=RP

SMSMP

指定要使用之Configuration Manager用戶端的初始管理點。

重要事項

如果管理點只接受透過 HTTPS 的用戶端連線,請在管理點名稱前面加上 https://

範例:

  • CCMSetup.exe SMSMP=smsmp01.contoso.com

  • CCMSetup.exe SMSMP=https://smsmp01.contoso.com

SMSMPLIST

指定要使用之Configuration Manager用戶端的管理點清單。 指定多個管理點時,請使用分號 (;) 作為分隔符號。

重要事項

如果管理點只接受透過 HTTPS 的用戶端連線,請在管理點名稱前面加上 https://

範例:

  • CCMSetup.exe SMSMPLIST=https://smsmp01.contoso.com;https://smsmp02.contoso.com;smsmp03.contoso.com

  • CCMSetup.exe SMSMPLIST=https://smsmp01.contoso.com;smsmp02.contoso.com;smsmp03.contoso.com

SMSPUBLICROOTKEY

如果用戶端無法從 Active Directory 網域服務 取得Configuration Manager受信任的根金鑰,請使用此屬性來指定金鑰。 此屬性適用于使用 HTTP 和 HTTPS 通訊的用戶端。 如需詳細資訊,請參閱 規劃受信任的根金鑰

範例:CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

提示

從月臺伺服器上的 mobileclient.tcf 檔案取得月臺受根信任金鑰的值。 如需詳細資訊,請 參閱使用檔案預先布建具有受根信任金鑰的用戶端

SMSROOTKEYPATH

使用此屬性重新安裝Configuration Manager受信任的根金鑰。 它會指定包含受根信任金鑰之檔案的完整路徑和名稱。 此屬性適用于使用 HTTP 和 HTTPS 用戶端通訊的用戶端。 如需詳細資訊,請參閱 規劃受信任的根金鑰

範例:CCMSetup.exe SMSROOTKEYPATH=C:\folder\trk

SMSSIGNCERT

指定網站伺服器上匯出之自我簽署憑證的完整路徑和名稱。 月臺伺服器會將此憑證儲存在 SMS 憑證存放區中。 它具有主體名稱 月臺伺服器 和易記名稱 月臺伺服器簽署憑證

匯出沒有私密金鑰的憑證、安全地儲存檔案,以及只從安全通道存取。

範例:CCMSetup.exe /UsePKICert SMSSIGNCERT=C:\folder\smssign.cer

SMSSITECODE

此屬性會指定您指派用戶端的Configuration Manager月臺。 這個值可以是三個字元的月臺碼或一字 AUTO 。 如果您指定 AUTO 或未指定此屬性,用戶端會嘗試從Active Directory 網域服務或從指定的管理點判斷其月臺指派。 若要啟用 AUTO 用戶端升級,也請設定 SITEREASSIGN=TRUE

注意事項

如果您也使用 屬性指定以網際網路為基礎的管理點 CCMHOSTNAME ,請勿搭配 使用 AUTOSMSSITECODE 藉由指定月臺碼,直接將用戶端指派給其月臺。

範例:CCMSetup.exe SMSSITECODE=XZY

UPGRADETOLATEST

此屬性會強制 CCMSetup 將位置要求傳送至管理點,以取得最新版的 Configuration Manager 用戶端安裝來源。 有幾個案例特別適合此屬性:

  • 生產前用戶端。 新安裝的用戶端會使用生產基準,因為它在安裝用戶端之前無法評估生產前集合。 在該案例中,安裝用戶端並評估原則之後,它稍後會升級至生產階段前用戶端版本。 使用此屬性可讓裝置立即安裝最新版的用戶端。

    此案例也包括使用 Autopilot 進行共同管理時。 使用此屬性可確保新布建的 Autopilot 裝置立即使用生產前用戶端版本。

  • 提取發佈點。 允許提取發佈點安裝最新的用戶端版本,即使它不在生產階段前集合中也一致。 此動作可確保提取發佈點上的用戶端版本與發佈點二進位檔相同。 如果這些版本不同,可能會造成問題。

憑證選取準則的屬性值

Configuration Manager支援下列 PKI 憑證選取準則的屬性值:

OID 屬性 辨別名稱屬性 屬性定義
0.9.2342.19200300.100.1.25 直流 網域元件
1.2.840.113549.1.9.1 電子郵件或電子郵件 電子郵件地址
2.5.4.3 快遞 之 家 一般名稱
2.5.4.4 主體名稱
2.5.4.5 SERIALNUMBER 序號
2.5.4.6 C 國碼
2.5.4.7 L 地區
2.5.4.8 S 或 ST 州或省名稱
2.5.4.9 街道地址
2.5.4.10 O 組織名稱
2.5.4.11 OU 組織單位
2.5.4.12 T 或標題 標題
2.5.4.42 G 或 GN 或 GivenName 指定的名稱
2.5.4.43 I 或 Initials 縮寫
2.5.29.17 (沒有值) 主體別名

用戶端推入安裝

如果您使用用戶端推入安裝方法,請在 Configuration Manager 主控台中 [用戶端推入安裝內容] 的 [客戶端] 索引標籤上使用下列選項:

  • 任何 Client.msi 屬性

  • 用戶端推送允許下列 CCMSetup.exe 命令列參數 子集:

    • /AllowMetered (從 2103 版開始)

    • /AlwaysExcludeUpgrade

    • /BITSPriority

    • /downloadtimeout

    • /ExcludeFeatures

    • /forcereboot

    • /logon

    • /skipprereq

    • /UsePKICert