次の方法で共有


New-CMProgram

パッケージの新しいプログラムを作成します。

構文

New-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   -CommandLine <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   -PackageName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RunMode <RunModeType>]
   [-RunType <RunType>]
   -StandardProgramName <String>
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   -CommandLine <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   -PackageId <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RunMode <RunModeType>]
   [-RunType <RunType>]
   -StandardProgramName <String>
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMProgram
   -CommandLine <String>
   [-CommandLineFolder <String>]
   [-Comment <String>]
   -DeviceProgramName <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMProgram
   -CommandLine <String>
   [-CommandLineFolder <String>]
   [-Comment <String>]
   -DeviceProgramName <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageId <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、パッケージのプログラムを作成します。 プログラムは、Configuration Manager パッケージに関連付けられているコマンドです。 クライアントがクライアント パッケージを受け取ったときに発生するアクションを識別します。 複数のプログラムを同じパッケージに関連付けることができます。 詳細については、「 Configuration Manager のパッケージとプログラム」を参照してください。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例 1: プログラムを作成する

この例では、最初にコマンドレット パラメーターを parameters 変数にスプラットします。 パラメーターをスプラッタする必要はありません。これにより、このような長いコマンド ラインのパラメーターを読みやすくなります。

このコマンドは、既定のユーザー状態移行ツール for Windows パッケージに Scan x64 という名前のプログラムを作成します。

$parameters = @{
  PackageName = "User State Migration Tool for Windows"
  StandardProgramName = "Scan x64"
  CommandLine = "amd64\scanstate.exe \\gold\sources$\userdata /i:miguser.xml /i:migapp.xml /o"
  RunType = "Normal"
  ProgramRunType = "OnlyWhenNoUserIsLoggedOn"
  DiskSpaceRequirement = 200
  DiskSpaceUnit = "MB"
  Duration = 100
  DriveMode = "RunWithUnc"
}
New-CMProgram @parameters

パラメーター

-AddSupportedOperatingSystemPlatform

プログラムに追加する 1 つ以上のサポートされている OS プラットフォームを指定します。 このオブジェクトを取得するには、 Get-CMSupportedPlatform コマンドレットを 使用します。

型:IResultObject[]
Aliases:AddSupportedOperatingSystemPlatforms
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CommandLine

プログラムのコマンド ラインを指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CommandLineFolder

実行可能プログラムを含むフォルダーを指定します。 このフォルダーには、クライアント上の絶対パス、またはパッケージを含む配布フォルダーを基準としたパスを指定できます。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Comment

説明など、プログラムに関する省略可能なテキストを指定します。 クライアント コンピューターでは、このテキストはソフトウェア センターのプログラムと共に表示されます。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DeviceProgramName

デバイス プログラム名を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DiskSpaceRequirement

ソフトウェア プログラムをコンピューターで実行するために必要なディスク領域の量を指定します。 値は 0 以上である必要があります。 値を指定する場合は、 DiskSpaceUnit パラメーターを使用して値の単位を指定します。

型:String
Aliases:DiskSpaceReq
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DiskSpaceUnit

DiskSpaceRequirement パラメーターに受け入れられるユニットを指定します。

型:DiskSpaceUnitType
指定可能な値:KB, MB, GB
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DownloadProgramType

プログラムを実行するタイミングを指定します。

型:DownloadProgramType
指定可能な値:AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DriveLetter

DriveMode パラメーターを使用する場合は、場所のドライブ文字を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DriveMode

プログラムに DriveLetter パラメーターで指定された特定のドライブ文字が必要かどうかを示します。

  • RunWithUnc: UNC パスからプログラムを実行します。 この値が既定値です。 バージョン 2010 以降では、この値の名前は RenameWithUnc から変更されました。

  • RequiresDriveLetter: プログラムは、使用可能なドライブ文字を使用します。

  • RequiresSpecificDriveLetter: プログラムは、ドライブがまだ使用されていない場合にのみ実行されます。

型:DriveModeType
指定可能な値:RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Duration

プログラムの実行が予想される最大時間を指定します。 既定値は 120 分です。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PackageId

このプログラムのパッケージの ID を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PackageName

このプログラムのパッケージ名を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProgramRunType

プログラムを実行するために必要なログオン条件を指定します。

既定の設定は OnlyWhenUserIsLoggedOnです。

型:ProgramRunType
指定可能な値:OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Reconnect

ユーザーが Windows にサインインしたときに、クライアント コンピューターが配布ポイントに再接続するかどうかを示します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Requirement

標準プログラムまたはデバイス プログラムの追加要件を指定します。

型:String
Aliases:Requirements
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RunMode

クライアント コンピューターでプログラムを実行するために必要な資格情報を指定します。

型:RunModeType
指定可能な値:RunWithUserRights, RunWithAdministrativeRights
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RunType

クライアント コンピューターでプログラムを実行するモードを指定します。

既定値は Normal です。

型:RunType
指定可能な値:Normal, Minimized, Maximized, Hidden
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-StandardProgramName

標準プログラム名を指定してください。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UserInteraction

ユーザーがプログラムとの対話を許可するかどうかを示します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WorkingDirectory

プログラムの作業ディレクトリを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

IResultObject

メモ

この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_Program」を参照してください。