Set-CMProgram
パッケージのプログラムを変更します。
構文
Set-CMProgram
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-AfterRunningType <AfterRunningType>]
[-Category <String>]
[-CommandLine <String>]
[-Comment <String>]
[-DisableMomAlertOnRun <Boolean>]
[-DisableProgram <Boolean>]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DriveLetter <String>]
[-DriveMode <DriveModeType>]
[-Duration <Int32>]
[-EnableTaskSequence <Boolean>]
[-GenerateMomAlertOnFail <Boolean>]
-InputObject <IResultObject>
[-PassThru]
[-ProgramAssignedType <ProgramAssignedType>]
[-ProgramRunType <ProgramRunType>]
[-Reconnect <Boolean>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-Requirement <String>]
[-RunMode <RunModeType>]
[-RunOnAnyPlatform]
[-RunType <RunType>]
[-StandardProgram]
[-SuppressProgramNotification <Boolean>]
[-UserInteraction <Boolean>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-AfterRunningType <AfterRunningType>]
[-Category <String>]
[-CommandLine <String>]
[-Comment <String>]
[-DisableMomAlertOnRun <Boolean>]
[-DisableProgram <Boolean>]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DriveLetter <String>]
[-DriveMode <DriveModeType>]
[-Duration <Int32>]
[-EnableTaskSequence <Boolean>]
[-GenerateMomAlertOnFail <Boolean>]
-PackageName <String>
[-PassThru]
[-ProgramAssignedType <ProgramAssignedType>]
-ProgramName <String>
[-ProgramRunType <ProgramRunType>]
[-Reconnect <Boolean>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-Requirement <String>]
[-RunMode <RunModeType>]
[-RunOnAnyPlatform]
[-RunType <RunType>]
[-StandardProgram]
[-SuppressProgramNotification <Boolean>]
[-UserInteraction <Boolean>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-AfterRunningType <AfterRunningType>]
[-Category <String>]
[-CommandLine <String>]
[-Comment <String>]
[-DisableMomAlertOnRun <Boolean>]
[-DisableProgram <Boolean>]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DriveLetter <String>]
[-DriveMode <DriveModeType>]
[-Duration <Int32>]
[-EnableTaskSequence <Boolean>]
[-GenerateMomAlertOnFail <Boolean>]
-PackageId <String>
[-PassThru]
[-ProgramAssignedType <ProgramAssignedType>]
-ProgramName <String>
[-ProgramRunType <ProgramRunType>]
[-Reconnect <Boolean>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-Requirement <String>]
[-RunMode <RunModeType>]
[-RunOnAnyPlatform]
[-RunType <RunType>]
[-StandardProgram]
[-SuppressProgramNotification <Boolean>]
[-UserInteraction <Boolean>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-AfterRunningType <AfterRunningType>]
[-Category <String>]
[-CommandLine <String>]
[-Comment <String>]
[-DisableMomAlertOnRun <Boolean>]
[-DisableProgram <Boolean>]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DriveLetter <String>]
[-DriveMode <DriveModeType>]
[-Duration <Int32>]
[-EnableTaskSequence <Boolean>]
[-GenerateMomAlertOnFail <Boolean>]
-InputObject <IResultObject>
[-PassThru]
[-ProgramAssignedType <ProgramAssignedType>]
-ProgramName <String>
[-ProgramRunType <ProgramRunType>]
[-Reconnect <Boolean>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-Requirement <String>]
[-RunMode <RunModeType>]
[-RunOnAnyPlatform]
[-RunType <RunType>]
[-StandardProgram]
[-SuppressProgramNotification <Boolean>]
[-UserInteraction <Boolean>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-CommandLine <String>]
[-CommandLineFolder <String>]
[-Comment <String>]
[-DeviceProgram]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DownloadProgramType <DownloadProgramType>]
-PackageName <String>
[-PassThru]
-ProgramName <String>
[-Requirement <String>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-CommandLine <String>]
[-CommandLineFolder <String>]
[-Comment <String>]
[-DeviceProgram]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DownloadProgramType <DownloadProgramType>]
-PackageId <String>
[-PassThru]
-ProgramName <String>
[-Requirement <String>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-CommandLine <String>]
[-CommandLineFolder <String>]
[-Comment <String>]
[-DeviceProgram]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DownloadProgramType <DownloadProgramType>]
-InputObject <IResultObject>
[-PassThru]
-ProgramName <String>
[-Requirement <String>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-CommandLine <String>]
[-CommandLineFolder <String>]
[-Comment <String>]
[-DeviceProgram]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DownloadProgramType <DownloadProgramType>]
-InputObject <IResultObject>
[-PassThru]
[-Requirement <String>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]説明
このコマンドレットを使用して、パッケージのプログラムを変更します。 プログラムは、クライアントがクライアント パッケージを受け取ったときに発生するアクションを識別します。 複数のプログラムを同じパッケージに関連付けることができます。 詳細については、「 Configuration Manager のパッケージとプログラム」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 標準プログラムを変更する
Set-CMProgram -Name "Test" -StandardProgramName SPM -Comment "Standard Upgrades" -CommandLine "RunThisNow" -RunType Maximized -AfterRunningType ProgramControlsRestart -Category "Laptops" -DiskSpaceRequirement 50 -DiskSpaceUnit MB -Duration 150 -Requirement 4 -Reconnect $False -SuppressProgramNotifications $False -DisableProgram $True -EnableTaskSequence $True -DisableMomAlertOnRun $True -GenerateMomAlertOnFail $True例 2: デバイス・プログラムを変更する
Set-CMProgram -Name "Test" -DeviceProgramName DPM -Comment "Upgrades for December" -CommandLine "RunMe" -WorkingDirectory "\TempWork" -CommandLineFolder "C:\Windows" -DiskSpaceRequirement 30 -DiskSpaceUnit MB -DownloadProgramType AsSoonAsPossible -Requirement "All previous device updates"例 3: サポートされている OS プラットフォームを追加する
次の使用例は、標準パッケージに関連付けられているプログラムの OS 要件を設定します。 Get-CMSupportedPlatform コマンドレットを使用して、指定したプラットフォームのオブジェクトを取得します。 次に、このサポートされているプラットフォーム オブジェクトを使用してプログラムを構成します。
$ProgramName = 'Script'
$PackageID = 'XYZ0000D'
$Platform = 'All Windows 10 (64-bit) Client'
$OS = Get-CMSupportedPlatform -Name $Platform -Fast
Set-CMProgram -PackageID $PackageID -ProgramName $ProgramName -AddSupportedOperatingSystemPlatform $OS -StandardProgramパラメーター
-AddSupportedOperatingSystemPlatform
プログラムに追加する 1 つ以上のサポートされている OS プラットフォームを指定します。 このオブジェクトを取得するには、 Get-CMSupportedPlatform コマンドレットを 使用します。
| 型: | IResultObject[] |
| Aliases: | AddSupportedOperatingSystemPlatforms |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AfterRunningType
プログラムが正常に完了した後に発生するアクションを指定します。
| 型: | AfterRunningType |
| 指定可能な値: | NoActionRequired, ConfigurationManagerRestartsComputer, ProgramControlsRestart, ConfigurationManagerLogsUserOff |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Category
クライアント コンピューターにプログラムを表示するカテゴリを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CommandLine
プログラムのコマンド ラインを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | 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 |
-DeviceProgram
このプログラムをデバイス プログラムとして構成するには、このパラメーターを追加します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableMomAlertOnRun
プログラムを実行しているコンピューターが、プログラムの期間中メンテナンス モードであるかどうかを示します。 メンテナンス モードの場合、System Center Operations Manager はプログラムの実行中にアラートを無効にします。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableProgram
このプログラムを含むすべてのデプロイを一時的に無効にするには、このパラメーターを $true に設定します。
Disable-CMProgram コマンドレットを使用することもできます。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DiskSpaceRequirement
ソフトウェア プログラムをコンピューターで実行するために必要なディスク領域の量を指定します。 値は 0 以上である必要があります。 値を指定する場合は、 DiskSpaceUnit パラメーターを使用して値の単位を指定します。
| 型: | String |
| 配置: | 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 |
-EnableTaskSequence
[パッケージのインストール] タスク シーケンス ステップからこのプログラムを インストール できるかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-GenerateMomAlertOnFail
プログラムが失敗した場合に Configuration Manager によってアプリケーション ログ イベント エントリが生成されるかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
構成するプログラム オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMProgram コマンドレットを 使用します。
| 型: | IResultObject |
| Aliases: | ProgramPackage, Package, Program |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PackageId
構成するプログラムでパッケージ ID を指定します。
| 型: | String |
| Aliases: | Id |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PackageName
構成するプログラムでパッケージ名を指定します。
| 型: | String |
| Aliases: | Name |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PassThru
作業中のアイテムを表す オブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ProgramAssignedType
プログラムをコンピューターで 1 回実行するか、コンピューターにサインインするすべてのユーザーに対して 1 回実行するかを指定します。 既定値は RunOnceForTheComputer です。
ProgramRunType パラメーターが OnlyWhenUserIsLoggedOn に設定されている場合にのみ、プログラムがユーザーに割り当てられます。
| 型: | ProgramAssignedType |
| 指定可能な値: | RunOnceForTheComputer, RunOnceForEveryUserWhoLogsOn |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ProgramName
構成するプログラムの名前を指定します。
| 型: | String |
| Aliases: | StandardProgramName, DeviceProgramName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ProgramRunType
プログラムを実行するために必要なログオン条件を指定します。 既定値は OnlyWhenUserIsLoggedOn です。
| 型: | ProgramRunType |
| 指定可能な値: | OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Reconnect
ユーザーがサインインしたときにクライアント コンピューターが配布ポイントに再接続するかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RemoveSupportedOperatingSystemPlatform
プログラムに対して削除する 1 つ以上のサポートされている OS プラットフォームを指定します。 このオブジェクトを取得するには、 Get-CMSupportedPlatform コマンドレットを 使用します。
| 型: | IResultObject[] |
| Aliases: | RemoveSupportedOperatingSystemPlatforms |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Requirement
標準プログラムまたは装置プログラムの追加要件を指定してください。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunMode
クライアント コンピューターがプログラムを実行するために必要な資格情報を指定します。
| 型: | RunModeType |
| 指定可能な値: | RunWithUserRights, RunWithAdministrativeRights |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunOnAnyPlatform
このプログラムからサポートされているすべての OS プラットフォームをクリアするには、このパラメーターを追加します。
| 型: | SwitchParameter |
| Aliases: | ClearSupportedOperatingSystemPlatforms |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunType
クライアント コンピューターでプログラムを実行するモードを指定します。 既定値は Normal です。
| 型: | RunType |
| 指定可能な値: | Normal, Minimized, Maximized, Hidden |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-StandardProgram
デプロイ パッケージのプログラムの種類が標準プログラムであることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SuppressProgramNotification
プログラム通知を抑制するには、このパラメーターを $true に設定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | 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 |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object