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

適用対象: Configuration Manager (Current Branch)

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

CCMSetup.exeについて

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

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

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

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

注意

client.msiを直接インストールすることはできません。

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

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

重要

client.msiのプロパティを指定する前に、CCMSetup パラメーターを指定します。

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

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

注意

パラメーターを /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 インストール ディレクトリ内のフォルダーにある mobileclienttemplate.tcf ファイル\bin\<platform>を使用します。 このファイルには、セクションとその使用方法に関するコメントがあります。 セクションで、次のテキストの後に [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 クライアントにソフトウェア センターをインストールしません。

注意

ClientUI は、パラメーターがサポートする唯一の /ExcludeFeatures 値です。

/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
    
  • パラメーターと https:// 共に使用するプレフィックスを /mp 追加します。

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

重要

パラメーターのクラウド管理ゲートウェイの URL を指定する場合は、最初https:///mp .

/NoCRLCheck

クライアントが PKI 証明書を使用して HTTPS 経由で通信するときに、証明書失効リスト (CRL) を確認しないように指定します。 このパラメーターを指定しないと、クライアントは HTTPS 接続を確立する前に CRL をチェックします。 クライアント 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 クライアント認証証明書を使用するクライアントにこのパラメーターを指定します。 このパラメーターを含めない場合、またはクライアントが有効な証明書を見つけられない場合は、クラウド管理ゲートウェイ (CMG) を含むすべての HTTPS 管理ポイントが除外されます。 クライアントは、自己署名証明書を使用して HTTP 接続を使用します。

例: CCMSetup.exe /UsePKICert

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

注意

一部のシナリオでは、このパラメーターを指定する必要はありませんが、クライアント証明書を引き続き使用します。 たとえば、クライアント プッシュとソフトウェアの更新ベースのクライアント インストールなどです。 クライアントを手動でインストールし、HTTPS 対応管理ポイントでパラメーターを /mp 使用する場合は、このパラメーターを使用します。

インターネットのみの通信用にクライアントをインストールするときにも、このパラメーターを指定します。 インターネット ベースの管理ポイント () とサイト コードSMSSITECODE (CCMHOSTNAME) のプロパティと共に使用CCMALWAYSINF=1します。 インターネット ベースのクライアント管理の詳細については、「 インターネットまたは信頼されていないフォレストからのクライアント通信に関する考慮事項」を参照してください。

/IgnoreSkipUpgrade

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

CCMSetup.exeリターン コード

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

リターン コード 意味
0 成功
6 Error
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.execlient.msiのインストール動作を変更できます。

AADCLIENTAPPID

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

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

AADRESOURCEURI

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

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

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

AADTENANTID

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

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

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

  • [デバイスの状態] セクションで、 TenantId 値を見つけます。 たとえば、TenantId : 607b7853-6f6f-4d5d-b3d4-811c33fdd49a のように指定します。

    注意

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

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

CCMADMINS

クライアント設定とポリシーへのアクセス権を付与する 1 つ以上の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

このプロパティを使用して、証明書発行者の一覧を指定します。 この一覧には、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 クライアント証明書の選択の計画」を参照してください。

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 証明書の選択条件でサポートされている属性値」を参照してください。

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

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) が実行される日中の時間。 整数値を (午前 0 時) から 0 (午後 11 時) に 23 指定します。 既定では、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

重要

プロパティに CMG CCMHOSTNAME のアドレスを指定する場合は、 https://プレフィックス (. このプレフィックス /mp は、CMG の URL と共にのみ使用します。

CCMHTTPPORT

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

例: CCMSetup.exe CCMHTTPPORT=80

CCMHTTPSPORT

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

例: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443

CCMINSTALLDIR

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

ヒント

クライアント ファイルをインストールする場所に関係なく、常に フォルダーにccmcore.dll ファイルが %WinDir%\System32 インストールされます。 64 ビット OS では、フォルダーにccmcore.dllのコピーが %WinDir%\SysWOW64 インストールされます。 このファイルは、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

管理者がTRUEConfiguration Managerコントロール パネルで割り当てられたサイトを変更できないようにするには、このプロパティを設定します。

例: CCMSetup.exe DISABLESITEOPT=TRUE

DISABLECACHEOPT

TRUE に設定すると、管理ユーザーが Configuration Manager コントロール パネルでクライアント キャッシュ フォルダーの設定を変更できなくなります。

例: CCMSetup.exe DISABLECACHEOPT=TRUE

DNSSUFFIX

クライアントが DNS で発行する管理ポイントを検索するための DNS ドメインを指定します。 クライアントは、管理ポイントを見つけると、階層内の他の管理ポイントについてクライアントに通知します。 この動作は、クライアントが DNS から検出する管理ポイントは、階層内の任意の 1 つであることができることを意味します。

注意

クライアントが発行済み管理ポイントと同じドメイン内にある場合は、このプロパティを指定する必要はありません。 その場合、クライアントのドメインは、DNS で管理ポイントを検索するために自動的に使用されます。

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

注意

既定では、Configuration Managerは DNS 発行を有効にしません。

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

FSP

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

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

例: CCMSetup.exe FSP=SMSFP01

IGNOREAPPVVERSIONCHECK

このプロパティを設定した TRUE場合、クライアント インストーラーは Microsoft アプリケーション仮想化 (App-V) の最小必要なバージョンを確認しません。

重要

App-V をインストールせずにConfiguration Manager クライアントをインストールする場合、仮想アプリケーションをデプロイすることはできません。

例: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE

MANAGEDINSTALLER

このプロパティをccmsetup.exeに 1 設定すると、client.msiはマネージド インストーラーとして設定されます。 詳細については、「Windows Defender Application Control を使用してマネージド インストーラーによってデプロイされたアプリを自動的に許可する」を参照してください。

例: CCMSetup.exe MANGEDINSTALLER=1

NOTIFYONLY

このプロパティを有効にすると、クライアントは状態を報告しますが、検出された問題は修復されません。

例: CCMSetup.exe NOTIFYONLY=TRUE

詳細については、「 クライアントの状態を構成する方法」を参照してください

PROVISIONTS

このプロパティを使用して、サイトに正常に登録した後、クライアントでタスク シーケンスを開始します。

注意

タスク シーケンスがソフトウェアの更新プログラムまたはアプリケーションをインストールする場合、クライアントには有効なクライアント認証証明書が必要です。 トークン認証だけでは機能しません。 詳細については、「 リリース ノート - OS の展開」を参照してください。

たとえば、Windows Autopilot を使用して新しいWindows デバイスをプロビジョニングし、それをMicrosoft Intuneに自動登録してから、共同管理のためにConfiguration Manager クライアントをインストールします。 この新しいオプションを指定すると、新しくプロビジョニングされたクライアントはタスク シーケンスを実行します。 このプロセスにより、アプリケーションとソフトウェアの更新プログラムをインストールしたり、設定を構成したりするための柔軟性が向上します。

次のプロセスを使用します。

  1. OS 以外の展開タスク シーケンスを作成して、アプリのインストール、ソフトウェア更新プログラムのインストール、設定の構成を行います。

  2. このタスク シーケンス を、新しい組み込みコレクション であるすべてのプロビジョニング デバイスにデプロイします。 たとえば PRI20001、タスク シーケンスの展開 ID に注意してください。

    ヒント

    デプロイの目的は、使用可能でも必須でもかまいません。 デプロイ ID をプロパティ値として指定するので、目的は関係ありません。

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

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

      注意

      このメソッドには、追加の前提条件が含まれる場合があります。 たとえば、サイトをAzure Active Directoryに登録したり、コンテンツ対応のクラウド管理ゲートウェイを作成したりします。

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

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

注意

起動されたPROVISIONTSタスク シーケンスでは、既定の クライアント 設定 が使用されます。 このタスク シーケンスは、クライアントが登録された直後に開始されるため、カスタム クライアント設定を展開したコレクションには含まれません。 このタスク シーケンスを実行する前に、クライアントはカスタム クライアント設定を処理または適用しません。

タスク シーケンスを正しく機能させるには、既定のクライアント 設定 で特定の設定を変更する必要がある場合があります。 例:

  • Cloud Services グループ: クライアントがクラウド管理ゲートウェイを使用できるようにし、クラウド****配布ポイントへのアクセスを許可する
  • コンピューター エージェント グループ: 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: キャッシュを圧縮形式でMicrosoft Storeします。

  • FAILIFNOSPACE: キャッシュをインストールするための十分な領域がない場合は、Configuration Manager クライアントを削除します。

例: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS

SMSCACHESIZE

重要

クライアント設定は、クライアント キャッシュ フォルダー のサイズを指定するために使用できます。 これらのクライアント設定を追加すると、SMSCACHESIZE をclient.msi プロパティとして使用してクライアント キャッシュのサイズを指定することが効果的に置き換えられます。 詳細については、 キャッシュ サイズのクライアント設定に関するページを参照してください。

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

例: CCMSetup.exe SMSCACHESIZE=100

注意

クライアントを再インストールする場合は、SMSCACHESIZE``SMSCACHEFLAGSキャッシュ サイズを以前よりも小さくすることはできません。 前のサイズは最小値です。

SMSCONFIGSOURCE

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

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

例: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>

ヒント

サイト サーバー上の mobileclient.tcf ファイルから、サイトの信頼されたルート キーの値を取得します。 詳細については、「ファイルを 使用して信頼されたルート キーを使用してクライアントを事前プロビジョニングする」を参照してください。

SMSROOTKEYPATH

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

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

SMSSIGNCERT

サイト サーバーでエクスポートされた自己署名証明書の完全なパスと名前を指定します。 サイト サーバーは、この証明書を 携帯ショートメール 証明書ストアに格納します。 サブジェクト名 のサイト サーバー とフレンドリ名 のサイト サーバー署名証明書 があります。

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

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

SMSSITECODE

このプロパティは、クライアントを割り当てるConfiguration Manager サイトを指定します。 この値には、3 文字のサイト コードまたは単語 AUTOを指定できます。 このプロパティを指定AUTOした場合、または指定しなかった場合、クライアントは、Active Directory Domain Servicesまたは指定した管理ポイントからサイトの割り当てを決定しようとします。 クライアントのアップグレードを有効 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 DC ドメイン コンポーネント
1.2.840.113549.1.9.1 電子メールまたは電子メール 電子メール アドレス
2.5.4.3 CN 共通名
2.5.4.4 SN サブジェクト名
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 またはタイトル Title
2.5.4.42 G または GN または GivenName 指定された名前
2.5.4.43 I または Initials Initials
2.5.29.17 (値なし) サブジェクトの別名

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

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