New-CMProgram

モジュール:

ConfigurationManager

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

構文

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 のパッケージとプログラム」を参照してください。

注意

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

例

例 1: プログラムの作成

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

このコマンドは、スキャン パッケージの既定のユーザー状態移行ツールに Scan x64という名前のWindowsします。

$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 コマンドレットを使用 します。

Type:	IResultObject[]
Aliases:	AddSupportedOperatingSystemPlatforms
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CommandLine

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CommandLineFolder

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Comment

プログラムに関するオプションのテキスト (説明など) を指定します。 クライアント コンピューターでは、このテキストがソフトウェア センターのプログラムと一緒に表示されます。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeviceProgramName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskSpaceRequirement

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

Type:	String
Aliases:	DiskSpaceReq
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskSpaceUnit

DiskSpaceRequirement パラメーターに使用できる単位を指定します。

Type:	DiskSpaceUnitType
Accepted values:	KB, MB, GB
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DownloadProgramType

プログラムを実行する時間を指定します。

Type:	DownloadProgramType
Accepted values:	AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DriveLetter

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DriveMode

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

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

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

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

Type:	DriveModeType
Accepted values:	RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Duration

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

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageId

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ProgramRunType

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

既定の設定はです OnlyWhenUserIsLoggedOn 。

Type:	ProgramRunType
Accepted values:	OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Requirement

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

Type:	String
Aliases:	Requirements
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunMode

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

Type:	RunModeType
Accepted values:	RunWithUserRights, RunWithAdministrativeRights
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunType

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

既定値は Normal です。

Type:	RunType
Accepted values:	Normal, Minimized, Maximized, Hidden
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-StandardProgramName

標準プログラム名を指定します。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UserInteraction

ユーザーがプログラムを操作できるかどうかを示します。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkingDirectory

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-再接続

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

入力

None

出力

IResultObject

メモ

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

関連リンク

• Disable-CMProgram
• Enable-CMProgram
• Get-CMProgram
• Remove-CMProgram
• Set-CMProgram
• Configuration Manager のパッケージとプログラム