Configuration Manager のクライアントのインストール パラメーターとプロパティについて

Configuration Manager (現在のブランチ) に適用

CCMSetup.exe コマンドを使用して、Configuration Manager クライアントをインストールします。 クライアントのインストール パラメーター をコマンド ラインに指定すると、インストール動作が変更されます。 コマンド ラインでクライアントのインストール プロパティ を指定すると、インストールされているクライアント エージェントの初期構成が変更されます。

CCMSetup.exe について

CCMSetup.exe コマンドは、クライアントをインストールするために必要なファイルを管理ポイントまたはソースの場所からダウンロードします。 これらのファイルには次のものが含まれます。

• クライアント ソフトウェアをインストールする Windows インストーラー パッケージ client.msi

• クライアントの前提条件

• Configuration Manager クライアントの Updates と修正プログラム

CCMSetup.exe には、インストールをカスタマイズするためのコマンド ライン パラメーター が用意されています。 パラメーターの前にはスラッシュ (/) が付き、通常は小文字になります。 必要に応じて、コロン (:) の直後に値を使用してパラメーターの値を指定します。 詳細については、「 CCMSetup.exe コマンド ライン パラメーター」を参照してください。

また、CCMSetup.exe コマンド ラインで プロパティ を指定して、client.msi 動作を変更することもできます。 規則によるプロパティは大文字です。 プロパティの値を指定するには、直後に等号 (=) を入力します。 詳細については、「 Client.msi プロパティ」を参照してください。

CCMSetup.exe とサポート ファイルは、Configuration Manager インストール フォルダーのクライアント フォルダーのサイト サーバー上にあります。 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 という名前の管理ポイントを指定して、クライアント インストール ファイルをダウンロードする配布ポイントの一覧を要求します。

• クライアントのバージョンが既にコンピューターに存在する場合にインストールを停止するように指定します。

• クライアントをサイト コード S01 に割り当てるように client.msi に指示します。

• SMSFP01 という名前のフォールバック ステータス ポイントを使用するように client.msi に指示します。

Configuration Manager の Active Directory スキーマを拡張すると、サイトは Active Directory Domain Services の多くのクライアント インストール プロパティを公開します。 Configuration Manager クライアントは、これらのプロパティを自動的に読み取ります。 詳細については、「Active Directory Domain Services に公開されているクライアントのインストール プロパティについて」を参照してください

コマンド ライン パラメーター CCMSetup.exe

/?

ccmsetup.exe で使用できるコマンド ライン パラメーターを表示します。

例: ccmsetup.exe /?

/AllowMetered

このパラメーターを使用して、従量制課金ネットワークでのクライアントの動作を制御します。 このパラメーターは値を受け取りません。 ccmsetup のために従量制課金ネットワークでのクライアント通信を許可すると、コンテンツがダウンロードされ、サイトに登録され、初期ポリシーがダウンロードされます。 それ以降のクライアント通信は、そのポリシーのクライアント設定の構成に従います。 詳細については、「 クライアント設定について」を参照してください。

既存のデバイスにクライアントを再インストールする場合は、次の優先順位を使用して構成が決定されます。

1. 既存のローカル クライアント ポリシー
2. Windows レジストリに保存されている最後のコマンド ライン
3. ccmsetup コマンド ラインのパラメーター

/AlwaysExcludeUpgrade

このパラメータは、 クライアントの自動アップグレードを有効にする場合に、クライアントを自動アップグレードするかどうかを指定します。

サポートされている値:

• TRUE: クライアントは自動的にアップグレードされません
• FALSE: クライアントは自動的にアップグレードされます (既定)

例:

CCMSetup.exe /AlwaysExcludeUpgrade:TRUE

詳細については、「 拡張相互運用性クライアント」を参照してください。

/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 分 (1 日) です。

/retry パラメーターを使用して、再試行の間隔を指定します。

例: ccmsetup.exe /downloadtimeout:100

/ExcludeFeatures

このパラメーターは、CCMSetup.exe が指定された機能をインストールしないことを指定します。

例: CCMSetup.exe /ExcludeFeatures:ClientUI はクライアントにソフトウェア センターをインストールしません。

/forceinstall

CCMSetup.exe が既存のクライアントをアンインストールし、新しいクライアントをインストールすることを指定します。

/forcereboot

このパラメータを使用すると、インストールを完了するために必要に応じてコンピュータを強制的に再起動できます。 このパラメーターを指定しない場合、再起動が必要なときに CCMSetup は終了します。 その後、次の手動再起動後に続行されます。

例: CCMSetup.exe /forcereboot

/logon

いずれかのバージョンのクライアントが既にインストールされている場合、このパラメーターはクライアントのインストールを停止することを指定します。

例: ccmsetup.exe /logon

/mp

クライアントがクライアント インストール ファイルの最寄りの配布ポイントを検索するために使用する管理ポイントを指定します。 配布ポイントがない場合、またはコンピューターが 4 時間経っても配布ポイントからファイルをダウンロードできない場合は、指定された管理ポイントからファイルをダウンロードします。

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

このパラメーターは、クラウド管理ゲートウェイ (CMG) の URL を指定することもできます。 この URL を使用して、インターネット ベースのデバイスにクライアントをインストールします。 このパラメーターの値を取得するには、次の手順を使用します。

• CMG を作成します。 詳細については、「 CMG のセットアップ」を参照してください。

• アクティブなクライアントで、管理者として Windows PowerShell コマンド プロンプトを開きます。

• 次のコマンドを実行します。

  (Get-WmiObject -Namespace Root\Ccm\LocationServices -Class SMS_ActiveMPCandidate | Where-Object {$_.Type -eq "Internet"}).MP
  

• /mp パラメーターで使用する https:// プレフィックスを付加します。

クラウド管理ゲートウェイ URL を使用する場合の例: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100

/NoCRLCheck

クライアントが HTTPS 経由で PKI 証明書と通信するときに、証明書失効リスト (CRL) をチェックしないように指定します。 このパラメーターを指定しない場合、クライアントは HTTPS 接続を確立する前に CRL を確認します。 クライアント CRL チェックの詳細については、「 PKI 証明書失効の計画」を参照してください。

例: CCMSetup.exe /UsePKICert /NoCRLCheck

/noservice

このパラメータは、CCMSetup が既定でサービスとして実行されるのを防ぎます。 CCMSetup がサービスとして実行される場合は、コンピューターのローカル システム アカウントのコンテキストで実行されます。 このアカウントには、インストールに必要なネットワーク リソースにアクセスするための十分なアクセス許可がない可能性があります。 /noservice では、インストールの開始に使用したユーザー アカウントのコンテキストで CCMSetup.exe が実行されます。

例: ccmsetup.exe /noservice

/regtoken

一括登録トークンを提供するには、このパラメーターを使用します。 インターネットベースのデバイスは、クラウド管理ゲートウェイ (CMG) を介した登録プロセスでこのトークンを使用します。 詳細については、「 CMG のトークン ベースの認証」を参照してください。

このパラメータを使用するときは、次のパラメータとプロパティも含めます。

• /mp
• CCMHOSTNAME
• SMSSITECODE
• SMSMP

次のコマンド ラインの例には、その他の必要なセットアップ パラメーターとプロパティが含まれています。

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

/retry

インストール ファイルのダウンロード CCMSetup.exe 失敗した場合は、このパラメーターを使用して再試行間隔を分単位で指定します。 CCMSetup は、 /downloadtimeout パラメーターで指定された制限に達するまで再試行を続けます。

例: ccmsetup.exe /retry:20

/service

CCMSetup がローカル システム アカウントを使用するサービスとして実行するように指定します。

例: 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 の動作の詳細についても説明します。

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

/uninstall

Configuration Manager クライアントをアンインストールするには、このパラメーターを使用します。 詳細については、「 クライアントのアンインストール」を参照してください。

例: ccmsetup.exe /uninstall

/UsePKICert

このパラメータは、クライアントが PKI クライアント認証証明書を使用するように指定します。 このパラメーターを含めない場合、またはクライアントが有効な証明書を見つけられない場合は、クラウド管理ゲートウェイ (CMG) を含むすべての HTTPS 管理ポイントがフィルターによって除外されます。 クライアントは、自己署名証明書を使用した HTTP 接続を使用します。

例: CCMSetup.exe /UsePKICert

デバイスがクライアント認証に Microsoft Entra ID を使用し、PKI ベースのクライアント認証証明書も持っている場合、このパラメーターを include を使用すると、クライアントはクラウド管理ゲートウェイ (CMG) から Microsoft Entra オンボード情報を取得できません。 Microsoft Entra 認証を使用するクライアントの場合は、このパラメーターを指定せずに、AADRESOURCEURI プロパティと AADCLIENTAPPID プロパティを含めてください。

/IgnoreSkipUpgrade

除外されたクライアントを手動でアップグレードするには、このパラメーターを指定します。 詳細については、「 アップグレードからクライアントを除外する方法」を参照してください。

CCMSetup.exe リターン コード

CCMSetup.exe コマンドでは、次のリターン コードが提供されます。 トラブルシューティングを行うには、クライアントの %WinDir%\ccmsetup\Logs\ccmsetup.log でコンテキストを確認し、リターン コードに関する追加の詳細を確認します。

Ccmsetup.msi プロパティ

次のプロパティは、ccmsetup.msi のインストール動作を変更できます。

CCMSETUPCMD

この ccmsetup を使用してください。追加のコマンド ライン パラメーターとプロパティを CCMSETUP に渡す msi プロパティ。exe. その他のパラメーターとプロパティを引用符 (") で囲みます。 Intune MDM のインストール方法で Configuration Manager クライアントをブートストラップするときに、このプロパティを使用します。

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

Client.msi プロパティ

次のプロパティは、ccmsetup.exe がインストールする client.msi のインストール動作を変更できます。

AADCLIENTAPPID

Microsoft Entra クライアント アプリ識別子を指定します。 クラウド管理用の Azure サービスを構成するときに、クライアント アプリを作成またはインポートします。 Azure 管理者は、Azure portal からこのプロパティの値を取得できます。 詳細については、「 アプリケーション ID の取得」を参照してください。 AADCLIENTAPPID プロパティの場合、このアプリケーション ID はネイティブ アプリケーションの種類用です。

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

AADRESOURCEURI

Microsoft Entra サーバー アプリの識別子を指定します。 クラウド管理用の Azure サービスを構成するときに、サーバー アプリを作成またはインポートします。 サーバー アプリケーションを作成するとき、[サーバー アプリケーションの作成] ウィンドウで、このプロパティは アプリ ID URI です。

Azure 管理者は、Azure portal からこのプロパティの値を取得できます。 Microsoft Entra ID の [アプリの登録] でサーバー アプリを見つけます。 アプリケーションの種類 Web アプリ/API を探します。 アプリを開き、[ 設定]、[ プロパティ] の順に選択します。 このAADRESOURCEURI クライアント インストール プロパティには、アプリ ID URI 値を使用します。

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

AADTENANTID

Microsoft Entra テナント識別子を指定します。 Configuration Manager は、クラウド管理用に Azure サービスを構成するときにこのテナントにリンクします。 このプロパティの値を取得するには、次の手順を使用します。

• Windows 10 以降を実行し、同じ Microsoft Entra テナントに参加しているデバイスで、コマンド プロンプトを開きます。

• 次のコマンドを実行します。dsregcmd.exe /status

• [デバイスの状態] セクションで、 TenantId 値を見つけます。 たとえば、TenantId : aaaabbbb-0000-cccc-1111-dddd2222eeee のように指定します。

  注:

  Azure 管理者は、Azure portal でこの値を取得することもできます。 詳細については、「 テナント ID の取得」を参照してください。

例: ccmsetup.exe AADTENANTID=aaaabbbb-0000-cccc-1111-dddd2222eeee

CCMADMINS

クライアント設定とポリシーへのアクセス権を付与する 1 つ以上の Windows ユーザー アカウントまたはグループを指定します。 このプロパティは、クライアント コンピューターにローカル管理者資格情報がない場合に便利です。 アカウントの一覧をセミコロン (;) で区切って指定します。

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

CCMALLOWSILENTREBOOT

必要に応じて、クライアントのインストール後にコンピューターを静かに再起動します。

例: CCMSetup.exe CCMALLOWSILENTREBOOT

CCMALWAYSINF

クライアントが常にインターネット ベースで、イントラネットに一切接続しないように指定するには、このプロパティ値を 1 に設定します。 クライアントの接続の種類には [常にインターネット] と表示されます。

このプロパティを 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."

証明書発行者リストの詳細と、証明書選択プロセス中のクライアントの使用方法については、「 PKI クライアント証明書の選択の計画」を参照してください。

CCMCERTNAMECHECK

バージョン 2207 以降では、このプロパティを使用して、証明書のサブジェクト名のチェックをスキップできます。 CCMCERTNAMECHECK=0 証明書のサブジェクト名のチェックをスキップします。

CCMCERTSEL

クライアントが HTTPS 通信用の証明書を複数持っている場合、このプロパティにより、有効なクライアント認証証明書を選択するための条件が指定されます。

次のキーワードを使用して、証明書のサブジェクト名またはサブジェクトの別名を検索します。

• Subject: 完全一致を検索します
• SubjectStr: 部分的な一致を見つける

例:

• CCMCERTSEL="Subject:computer1.contoso.com": サブジェクト名またはサブジェクトの別名で computer1.contoso.com コンピューター名と完全に一致する証明書を検索します。

• CCMCERTSEL="SubjectStr:contoso.com": サブジェクト名またはサブジェクトの別名に contoso.com が含まれている証明書を検索します。

SubjectAttr キーワード (keyword)を使用して、サブジェクト名またはサブジェクト別名でオブジェクト識別子 (OID) 属性または識別名属性を検索します。

例:

• CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": オブジェクト識別子として表され、 Computers という名前の組織単位属性を検索します。

• CCMCERTSEL="SubjectAttr:OU = Computers": 識別名として表現され、 Computers という名前の組織単位属性を検索します。

証明書の選択に使用できる属性の完全な一覧については、「 PKI 証明書の選択条件でサポートされている属性値」を参照してください。

複数の証明書が検索に一致し、 CCMFIRSTCERT を 1 に設定した場合、クライアント インストーラーは有効期間が最も長い証明書を選択します。

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 は 1 日に 1 回 (1440 分) 実行されます。

例: CCMSetup.exe CCMEVALINTERVAL=1440

クライアントの正常性評価の詳細については、「 クライアントの監視」を参照してください。

CCMEVALHOUR

クライアント正常性評価ツール (ccmeval.exe) が実行される日中の 1 時間。 0 (深夜) から 23 (午後 11:00) までの整数値を指定します。 既定では、ccmeval は午前 0 時に実行されます。

クライアントの正常性評価の詳細については、「 クライアントの監視」を参照してください。

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

CCMHTTPPORT

クライアントがサイト システム サーバーと HTTP 経由で通信するときに使用するポートを指定します。 既定では、この値は 80 です。

例: CCMSetup.exe CCMHTTPPORT=80

CCMHTTPSPORT

クライアントがサイト システム サーバーと HTTPS 経由で通信するときに使用するポートを指定します。 既定では、この値は 443 です。

例: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIR

このプロパティを使用して、Configuration Manager クライアント ファイルをインストールするフォルダーを設定します。 既定では %WinDir%\CCM を使用します。

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

CCMLOGLEVEL

このプロパティを使用して、Configuration Manager ログ ファイルに書き込む詳細レベルを指定します。

サポートされている値:

• 0: Verbose
• 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 から検出する管理ポイントが階層内の任意のものである可能性があることを意味します。

Configuration Manager クライアントのサービスの場所として DNS を公開する方法の詳細については、「サービスの場所およびクライアントが割り当てられた管理ポイントを決定する方法」を参照してください。

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

FSP

Configuration Manager クライアントによって送信された状態メッセージを受信して処理するフォールバック状態ポイントを指定します。

詳細については、「 フォールバック ステータス ポイントが必要かどうかを判断する」を参照してください。

例: CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

このプロパティを TRUE に設定すると、クライアント インストーラーは最低限必要なバージョンの Microsoft Application Virtualization (App-V) をチェックしません。

例: 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. このタスク シーケンス は、新しい組み込みコレクション All Provisioning Devices に展開します。 タスク シーケンスのデプロイ ID ( PRI20001 など) をメモします。

   ヒント

   展開の目的は、[使用可能] または [必須] のいずれかです。 展開 ID をプロパティ値として指定するため、目的は関係ありません。

3. ccmsetup.msiを使用してデバイスに Configuration Manager クライアントをインストールし、次のプロパティを含めます: PROVISIONTS=PRI20001。 このプロパティの値をタスク シーケンスのデプロイ ID として設定します。

   • 共同管理の登録中に Intune からクライアントをインストールする場合は、「共同管理用にインターネット ベースのデバイスを準備する方法」を参照してください。

     注:

     この方法には追加の前提条件がある場合があります。 たとえば、サイトを Microsoft Entra ID に登録したり、コンテンツ対応クラウド管理ゲートウェイを作成したりします。

     メソッドに関係なく、このプロパティは ccmsetup.msiでのみ使用します。

クライアントがインストールされ、サイトに適切に登録されると、参照されているタスク シーケンスが開始されます。 クライアントの登録に失敗した場合、タスク シーケンスは開始されません。

RESETKEYINFORMATION

クライアントが間違った Configuration Manager の信頼されたルート キーを持っている場合、クライアントは信頼された管理ポイントに接続して新しい信頼されたルート キーを受け取ることはできません。 このプロパティを使用して、古い信頼されたルート キーを削除します。 この状況は、クライアントを 1 つのサイト階層から別のサイト階層に移動する場合に発生する可能性があります。 このプロパティは、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 プロパティに従ってキャッシュ フォルダーをインストールします
• フォルダーが圧縮されていない
• クライアントは、キャッシュのサイズ制限 (MB 単位) として SMSCACHESIZE プロパティを使用します

既存のクライアントをアップグレードする場合、クライアント インストーラーはこのプロパティを無視します。

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

既存のクライアントをアップグレードする場合、クライアント インストーラーはこの設定を無視します。 また、クライアントはソフトウェア更新プログラムをダウンロードするときにキャッシュ サイズを無視します。

例: CCMSetup.exe SMSCACHESIZE=100

SMSCONFIGSOURCE

このプロパティを使用して、クライアント インストーラーが構成設定をチェックする場所と順序を指定します。 これは 1 つ以上の文字で構成された文字列であり、それぞれが特定の構成ソースを定義します。

• R: レジストリの構成設定を確認します。

  詳細については、「 クライアントのインストール プロパティのプロビジョニング」を参照してください。

• P: コマンド ラインのインストール プロパティで構成設定を確認します。

• M: 古いクライアントをアップグレードするときに、既存の設定を確認します。

• U: インストールされているクライアントを新しいバージョンにアップグレードし、割り当てられたサイト コードを使用します。

既定では、クライアント インストーラーは PU. 最初にインストールのプロパティ (P) を確認し、次に既存の設定 (U) を確認します。

例: CCMSetup.exe SMSCONFIGSOURCE=RP

SMSMP

Configuration Manager クライアントが使用する初期管理ポイントを指定します。

例:

• CCMSetup.exe SMSMP=smsmp01.contoso.com

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

SMSMPLIST

Configuration Manager クライアントが使用する管理ポイントの一覧を指定します。 複数の管理ポイントを指定する場合は、区切り記号としてセミコロン (;) を使用します。

例:

• 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 Domain Services から Configuration Manager の信頼されたルート キーを取得できない場合は、このプロパティを使用してキーを指定します。 このプロパティは、HTTP および HTTPS 通信を使用するクライアントに適用されます。 詳しくは、 信頼されたルート・キーの計画を参照してください。

例: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

SMSROOTKEYPATH

このプロパティを使用して、Configuration Manager の信頼されたルート キーを再インストールします。 信頼できるルート キーを含むファイルの完全パスと名前を指定します。 このプロパティは、HTTP および HTTPS クライアント通信を使用するクライアントに適用されます。 詳しくは、 信頼されたルート・キーの計画を参照してください。

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

SMSSIGNCERT

サイト サーバー上のエクスポートされた自己署名証明書の完全パスと名前を指定します。 サイト サーバーは、この証明書を SMS 証明書ストアに格納します。 サブジェクト名は Site Server で、フレンドリ名は Site Server Signing Certificateです。

秘密キーを使用せずに証明書をエクスポートし、ファイルを安全に保存し、セキュリティで保護されたチャネルからのみアクセスします。

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

SMSSITECODE

このプロパティにより、クライアントを割り当てる Configuration Manager サイトが指定されます。 この値は、3 文字のサイト コードまたは単語 AUTO のいずれかです。 AUTO を指定した場合、またはこのプロパティを指定しなかった場合、クライアントはActive Directory Domain Servicesまたは指定された管理ポイントからサイトの割り当ての決定を試みます。 クライアント アップグレードの AUTO を有効にするには、 SITEREASSIGN=TRUE も設定します。

例: CCMSetup.exe SMSSITECODE=XZY

UPGRADETOLATEST

このプロパティにより、CCMSetup は、最新バージョンの Configuration Manager クライアント インストール ソースを取得するために、管理ポイントに場所の要求を送信します。 このプロパティが特に役立つシナリオがいくつかあります。

• 実稼働前クライアント。 新しくインストールされたクライアントは、クライアントがインストールされるまで実稼働前コレクションを評価できないため、実稼働ベースラインを使用します。 このシナリオでは、クライアントがインストールされ、ポリシーが評価された後で、実稼働前のクライアント バージョンにアップグレードされます。 このプロパティを使用すると、デバイスに最新バージョンのクライアントが直ちにインストールされます。

  このシナリオには、 Windows Autopilot を使用して共同管理する場合も含まれます。 このプロパティを使用して、新しくプロビジョニングされた Windows Autopilot デバイスが運用前クライアント バージョンをすぐに使用できるようにします。

• 配布ポイントをプルします。 運用前コレクションに含まれていない場合でも、最新のクライアント バージョンをプル配布ポイントがインストールできるようにします。 このアクションにより、プル配布ポイントのクライアント バージョンが配布ポイントのバイナリと同じであることが確認されます。 これらのバージョンが同じでない場合は、問題が発生する可能性があります。

証明書選択条件の属性値

Configuration Manager では、PKI 証明書の選択条件に次の属性値がサポートされています。

クライアント プッシュ インストール

クライアント プッシュ インストール方法を使用する場合は、Configuration Manager コンソールのクライアント プッシュ インストールのプロパティの [クライアント] タブで次のオプションを使用します。

• Client.msi プロパティのいずれか

• CCMSetup.exe コマンド ライン パラメーターの次のサブセットをクライアント プッシュに使用できます。

  • /AllowMetered (バージョン 2103 以降)

  • /AlwaysExcludeUpgrade

  • /BITSPriority

  • /downloadtimeout

  • /ExcludeFeatures

  • /forcereboot

  • /logon

  • /skipprereq

  • /UsePKICert