パッケージ定義ファイル
Configuration Manager (現在のブランチ) に適用
パッケージ定義ファイルは、Configuration Managerでのパッケージとプログラムの作成を自動化するのに役立つスクリプトです。 パッケージとプログラムを作成するためにConfiguration Manager必要なすべての情報が提供されます(パッケージ ソース ファイルの場所を除く)。
パッケージ定義ファイルの形式について
各パッケージ定義ファイルは、.ini ファイル形式を使用する ASCII または UTF-8 テキスト ファイルです。 次のセクションが含まれています。
[PDF]
このセクションでは、ファイルをパッケージ定義ファイルとして識別します。 これには、次の情報が含まれています。
- バージョン: ファイルで使用するパッケージ定義ファイル形式のバージョンを指定します。 このバージョンは、書き込まれたConfiguration Managerのバージョンに対応します。 このエントリは必須です。
[パッケージ定義]
パッケージとプログラムのプロパティを指定します。 次の情報が提供されます。
名前: パッケージの名前 (最大 50 文字)。
バージョン (省略可能): パッケージのバージョン (最大 32 文字)。
アイコン (省略可能): このパッケージに使用するアイコンを含むファイル。 指定した場合、このアイコンは、Configuration Manager コンソールの既定のパッケージ アイコンに置き換えられます。
発行元: パッケージの発行元 (最大 32 文字)。
言語: パッケージの言語バージョン (最大 32 文字)。
コメント (省略可能): パッケージに関するコメント (最大 127 文字)。
ContainsNoFiles: このエントリは、パッケージにソース ファイルがあるかどうかを示します。
プログラム: このパッケージに対して定義するプログラム。 各プログラム名は、このパッケージ定義ファイルの [Program] セクションに対応します。
例:
Programs=Typical, Custom, Uninstall
MIFFileName: パッケージの状態を含む管理情報形式 (MIF) ファイルの名前 (最大 50 文字)。
MIFName: MIF 一致のパッケージの名前 (最大 50 文字)。
MIFVersion: MIF 照合用のパッケージのバージョン番号 (最大 32 文字)。
MIFPublisher: MIF マッチング用パッケージのソフトウェア発行元 (最大 32 文字)。
[プログラム]
[パッケージ定義] セクションの [プログラム ] エントリに 指定する各プログラムの [Program] セクションを含めます。 このセクションでは、各プログラムを定義します。 各プログラム セクションでは、次の情報を提供します。
名前: プログラムの名前(最大 50 文字)。 このエントリは、パッケージ内で一意である必要があります。
アイコン (省略可能): このプログラムに使用するアイコンを含むファイルを指定します。 このアイコンは、Configuration Manager コンソールの既定のプログラム アイコンに置き換えられます。 クライアントは、プログラムをコレクションに展開するときにもこのアイコンを表示します。
コメント (省略可能): プログラムに関するコメント (最大 127 文字)。
CommandLine: プログラムのコマンド ラインを指定します(最大 127 文字)。 コマンドは、パッケージ ソース フォルダーを基準にしています。
StartIn: プログラムの作業フォルダー (最大 127 文字) を指定します。 このエントリには、クライアント コンピューター上の絶対パス、またはパッケージ ソース フォルダーを基準とするパスを指定できます。
実行: プログラムを実行するプログラム モードを指定します。 最小化、最大化、または非表示を指定できます。 このエントリを含めない場合、プログラムは通常モードで実行されます。
AfterRunning: プログラムが正常に完了した後に発生する特別なアクションを指定します。 使用できるオプションは、 SMSRestart、 ProgramRestart、または SMSLogoff です。 このエントリを含めない場合、プログラムは特別なアクションを実行しません。
EstimatedDiskSpace: ソフトウェア プログラムをコンピューターで実行するために必要なディスク領域の量を指定します。 既定値は Unknown です。 値は、0 以上の整数として設定できます。 値を指定する場合は、値の単位も含めます。
例:
EstimatedDiskSpace=38MB
EstimatedRunTime: プログラムがクライアント コンピューターで実行される予定の推定期間を分単位で指定します。 既定値は 120 です。 値は、0 より大きい整数または 不明として設定できます。
例:
EstimatedRunTime=25
SupportedClients: このプログラムを実行するプロセッサとオペレーティング システムを指定します。 プラットフォームをコンマで区切ります。 このエントリを含めない場合、クライアントはこのプログラムでサポートされているプラットフォームを確認しません。
SupportedClientMinVersionX、 SupportedClientMaxVersionX: SupportedClients エントリで指定されているオペレーティング システムのバージョン番号の先頭から末尾までの範囲 を 指定します。
例:
SupportedClients=Win NT (I386),Win NT (IA64),Win NT (x64) Win NT (I386) MinVersion1=5.00.2195.4 Win NT (I386) MaxVersion1=5.00.2195.4 Win NT (I386) MinVersion2=5.10.2600.2 Win NT (I386) MaxVersion2=5.10.2600.2 Win NT (I386) MinVersion3=5.20.0000.0 Win NT (I386) MaxVersion3=5.20.9999.9999 Win NT (I386) MinVersion4=5.20.3790.0 Win NT (I386) MaxVersion4=5.20.3790.2 Win NT (I386) MinVersion5=6.00.0000.0 Win NT (I386) MaxVersion5=6.00.9999.9999 Win NT (IA64) MinVersion1=5.20.0000.0 Win NT (IA64) MaxVersion1=5.20.9999.9999 Win NT (x64) MinVersion1=5.20.0000.0 Win NT (x64) MaxVersion1=5.20.9999.9999 Win NT (x64) MinVersion2=5.20.3790.0 Win NT (x64) MaxVersion2=5.20.9999.9999 Win NT (x64) MinVersion3=5.20.3790.0 Win NT (x64) MaxVersion3=5.20.3790.2 Win NT (x64) MinVersion4=6.00.0000.0 Win NT (x64) MaxVersion4=6.00.9999.9999
AdditionalProgramRequirements (省略可能): クライアント コンピューターのその他の情報または要件 (最大 127 文字) を指定します。
CanRunWhen: クライアント コンピューターでプログラムを実行するために必要なユーザーの状態を指定します。 使用可能な値は 、UserLoggedOn、 NoUserLoggedOn、または AnyUserStatus です。 既定値は UserLoggedOn です。
UserInputRequired: プログラムがユーザーとの対話を必要とするかどうかを指定します。 使用可能な値は True または False です。 既定値は True です。 CanRunWhen が UserLoggedOn に設定されていない場合、このエントリは False に設定されます。
AdminRightsRequired: 実行するコンピューターの管理者資格情報がプログラムに必要かどうかを指定します。 使用可能な値は True または False です。 既定値は False です。 CanRunWhen が UserLoggedOn に設定されていない場合、このエントリは True に設定されます。
UseInstallAccount: プログラムがクライアント コンピューターで実行されるときにクライアント ソフトウェア インストール アカウントを使用するかどうかを指定します。 既定では、この値は False です。 この値は、CanRunWhen が UserLoggedOn に設定されている場合も False です。
DriveLetterConnection: プログラムが配布ポイント上のパッケージ ファイルへのドライブ文字接続を必要とするかどうかを指定します。 True または False を指定できます。 既定値は False です。これにより、プログラムは汎用名前付け規則 (UNC) 接続を使用できます。 この値を True に設定すると、クライアントは次に使用可能なドライブ文字を使用し、Z: から始まり、後方に進みます。
SpecifyDrive (省略可能): プログラムが配布ポイントのパッケージ ファイルに接続するために必要なドライブ文字を指定します。 この設定により、配布ポイントへのクライアント接続に指定したドライブ文字が強制的に使用されます。
ReconnectDriveAtLogon: ユーザーがサインインするときにコンピューターが配布ポイントに再接続するかどうかを指定します。 使用可能な値は True または False です。 既定値は False です。
DependentProgram: 現在のプログラムの前に実行する必要があるプログラムをこのパッケージに指定します。 このエントリでは、 という形式
DependentProgram=<ProgramName>
を使用します。ここで<ProgramName>
、 はパッケージ定義ファイル内のそのプログラムの 名前 エントリです。 依存プログラムがない場合は、このエントリを空のままにします。例:
DependentProgram=Admin
DependentProgram=
割り当て: プログラムをユーザーに割り当てる方法を指定します。 この値は次のとおりです。
- FirstUser: クライアントにサインインした最初のユーザーのみがプログラムを実行します
- EveryUser: サインインするすべてのユーザーがプログラムを実行します
CanRunWhen が UserLoggedOn に設定されていない場合、このエントリは FirstUser に設定されます。
無効: このプログラムをクライアントに展開できるかどうかを指定します。 使用可能な値は True または False です。 既定値は False です。
パッケージ定義ファイルを使用する
Configuration Manager コンソールで、[ソフトウェア ライブラリ] ワークスペースに移動し、[アプリケーション管理] を展開し、[パッケージ] ノードを選択します。
リボンの [ ホーム ] タブの [ 作成 ] グループで、[ 定義からパッケージの作成] を選択します。
定義からパッケージを作成ウィザードの [パッケージ定義] ページで、既存のパッケージ定義ファイルを選択します。 新しいパッケージ定義ファイルを開くには、[ 参照] を選択します。 新しいパッケージ定義ファイルを指定した後、 パッケージ定義 の一覧から選択します。
[ ソース ファイル ] ページで、パッケージとプログラムに必要なソース ファイルに関する情報を指定します。
パッケージにソース ファイルが必要な場合は、[ ソース フォルダー] ページで、サイトがソース ファイルを取得できる場所を指定します。
ウィザードを終了します。