關於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驗證的用戶端，請勿指定此參數，但包含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標識符] 中，尋找[應用程式註冊] 底下的伺服器應用程式。 尋找應用程式類型 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

使用此屬性來指定憑證簽發者清單。 此清單包含受信任根憑證授權單位的憑證資訊， (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) 執行的頻率，以分鐘為單位。 指定從 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用戶端以進行共同管理。 如果您指定這個新選項，則新布建的用戶端會執行工作順序。 此程式可讓您額外彈性地安裝應用程式和軟體更新，或設定設定。

使用下列程式：

  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

注意事項

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

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 ，請勿搭配 使用 AUTO 。 SMSSITECODE 藉由指定月臺碼，直接將用戶端指派給其月臺。

範例：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