適用於: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 在計量付費網路上進行用戶端通訊時,它會下載內容、向網站註冊,以及下載初始原則。 任何進一步的用戶端通訊都會遵循該原則的客戶端設定。 如需詳細資訊,請 參閱關於客戶端設定。
如果您在現有的裝置上重新安裝用戶端,它會使用下列優先順序來判斷其設定:
- 現有的本機客戶端原則
- 儲存在 Windows 登錄中的最後一個命令行
- ccmsetup 命令行上的參數
/AlwaysExcludeUpgrade
此參數會指定當您啟用 自動用戶端升級時,用戶端是否會自動升級。
支援的值:
-
TRUE:用戶端不會自動升級 -
FALSE:客戶端會自動升級預設 ()
例如:
CCMSetup.exe /AlwaysExcludeUpgrade:TRUE
如需詳細資訊,請參閱 延伸互作性用戶端。
注意事項
使用 /AlwaysExcludeUpgrade 參數時,自動升級仍會執行。 不過,當 CCMSetup 執行 以執行升級時,它會注意到 /AlwaysExcludeUpgrade 參數已設定,並且會在ccmsetup.log中記錄下列 這一行:
Client is stamped with /alwaysexcludeupgrade. Stop proceeding.
CCMSetup 接著會立即結束,而不會執行升級。
/BITSPriority
當裝置透過 HTTP 連線下載用戶端安裝檔案時,請使用此參數來指定下載優先順序。 指定下列其中一個可能值:
FOREGROUNDHIGHNORMAL(預設)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.exeCCMSetup.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 ID 進行客戶端驗證,而且也有 PKI 型用戶端驗證憑證,如果您使用包含此參數,用戶端將無法從雲端管理網關取得 Microsoft Entra 上線資訊, (CMG) 。 對於使用 Microsoft Entra 驗證的用戶端,請勿指定此參數,但請包含 AADRESOURCEURI 和 AADCLIENTAPPID 屬性。
注意事項
在某些情況下,您不需要指定此參數,但仍會使用用戶端憑證。 例如,用戶端推入和軟體更新型用戶端安裝。 當您手動安裝用戶端,並搭配啟用 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 ID 中,在 [應用程式註冊] 底下尋找伺服器應用程式。 尋找應用程式類型 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 參數 UsePKICert 和 SMSSITECODE 屬性使用。
如需因特網型用戶端管理的詳細資訊,請參 閱因特網或不受信任樹系的用戶端通訊考慮。
範例:CCMSetup.exe /UsePKICert CCMALWAYSINF=1 CCMHOSTNAME=SERVER3.CONTOSO.COM SMSSITECODE=ABC
CCMCERTISSUERS
使用此屬性來指定憑證簽發者清單。 此清單包含 Configuration Manager 月臺信任的受信任跟證書頒發機構單位 (CA) 的憑證資訊。
此值是根 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) 執行的頻率,以分鐘為單位。 指定從 1 到 1440的整數值。 根據預設,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 用戶端以進行共同管理。 如果您指定這個新選項,則新布建的客戶端會執行工作順序。 此程式可讓您額外彈性地安裝應用程式和軟體更新,或設定設定。
使用下列程式:
建立非 OS 部署工作順序 ,以安裝應用程式、安裝軟體更新,以及設定設定。
將此工作順序部署 至新的內建集合[ 所有布建裝置]。 請注意工作順序部署識別碼,例如
PRI20001。提示
部署的目的可以是可用或必要。 由於您將部署標識子指定為屬性值,因此目的並不重要。
使用ccmsetup.msi在裝置上安裝 Configuration Manager 客戶端,並包含下列屬性:
PROVISIONTS=PRI20001。 將此屬性的值設定為工作順序部署標識碼。如果您要在共同管理註冊期間從 Intune 安裝用戶端,請參閱如何準備以因特網為基礎的裝置以進行共同管理。
注意事項
此方法可能有其他必要條件。 例如,註冊網站以 Microsoft Entra ID,或建立已啟用內容的雲端管理網關。
不論方法為何,請只將這個屬性與 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
注意事項
如果您重新安裝用戶端,則無法使用 SMSCACHESIZE 或 SMSCACHEFLAGS ,將快取大小設定為小於先前的大小。 先前的大小是最小值。
SMSCONFIGSOURCE
使用此屬性來指定客戶端安裝程序檢查組態設定的位置和順序。 它是一或多個字元的字串,每個字元都會定義特定的組態來源:
R:檢查登錄中的組態設定。如需詳細資訊,請 參閱布建用戶端安裝屬性。
P:從命令行檢查安裝內容中的組態設定。M:當您升級較舊的用戶端時,請檢查現有的設定。U:將已安裝的用戶端升級至較新的版本,並使用指派的月臺碼。
根據預設,客戶端安裝程式會使用 PU。 它會先檢查安裝內容 (P) ,然後檢查現有的設定 (U) 。
範例:CCMSetup.exe SMSCONFIGSOURCE=RP
SMSMP
指定要使用之 Configuration Manager 用戶端的初始管理點。
重要事項
如果管理點只接受透過 HTTPS 的用戶端連線,請在管理點名稱前面加上 https://。
範例:
CCMSetup.exe SMSMP=smsmp01.contoso.comCCMSetup.exe SMSMP=https://smsmp01.contoso.com
SMSMPLIST
指定要使用之 Configuration Manager 用戶端的管理點清單。 指定多個管理點時,請使用分號 (;) 作為分隔符。
重要事項
如果管理點只接受透過 HTTPS 的用戶端連線,請在管理點名稱前面加上 https://。
範例:
CCMSetup.exe SMSMPLIST=https://smsmp01.contoso.com;https://smsmp02.contoso.com;smsmp03.contoso.comCCMSetup.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,請勿搭配 使用 AUTO 。SMSSITECODE 藉由指定月臺碼,直接將用戶端指派給其月臺。
範例:CCMSetup.exe SMSSITECODE=XZY
UPGRADETOLATEST
此屬性會強制 CCMSetup 將位置要求傳送至管理點,以取得最新版的 Configuration Manager 客戶端安裝來源。 有幾個案例特別適合此屬性:
生產前用戶端。 新安裝的用戶端會使用生產基準,因為它在安裝用戶端之前無法評估生產前集合。 在該案例中,安裝用戶端並評估原則之後,它稍後會升級至生產階段前用戶端版本。 使用此屬性可讓裝置立即安裝最新版的用戶端。
此案例也包括使用 Windows Autopilot 進行共同管理時。 使用此屬性可確保新布建的 Windows 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 控制台中 [用戶端推入安裝內容] 的 [客戶端] 索引標籤上使用下列選項:
用戶端推送允許下列 CCMSetup.exe 命令行參數 子集:
/AllowMetered(從2103版開始)/AlwaysExcludeUpgrade/BITSPriority/downloadtimeout/ExcludeFeatures/forcereboot/logon/skipprereq/UsePKICert