Set-CMApplicationDeployment

モジュール:

ConfigurationManager

アプリケーションのデプロイを構成する

構文

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   -InputObject <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   -ApplicationId <String>
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   -ApplicationName <String>
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-CMApplicationDeployment コマンドレットは、Configuration Manager でのアプリケーション展開のプロパティを変更します。 詳細については、「 Configuration Manager を使用してアプリケーションをデプロイする」を参照してください。

変更するアプリケーションのデプロイを指定するには、コレクション名とアプリケーションを指定します。 アプリケーションは、名前または ID で指定できます。 Get-CMApplication コマンドレットを使用して、変更するアプリケーションを取得することもできます。

注:

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

例

例 1: アプリケーションのデプロイの可用性と期限を変更する

Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)

このコマンドは、すべてのユーザーという名前のコレクションの Track System 2011 という名前のアプリケーションのアプリケーション展開を変更します。 コマンドは、アプリケーションが使用可能な場合の現在の日付を指定します。 また、今後 30 日間のデプロイ期限も構成します。

パラメーター

-AllowRepairApp

このパラメーターを使用して、アプリケーションのデプロイを作成するときに修復アプリケーション オプションを構成します。

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

-ApplicationId

アプリケーションの ID を指定します。

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

-ApplicationName

アプリケーションの名前を指定します。

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

-AutoCloseExecutable

バージョン 2107 以降では、インストール動作のアプリケーション展開設定を有効にするには、このパラメーターを $true に設定します。 次に、 Add-CMDeploymentTypeInstallBehavior コマンドレットを使用して、インストールが正常に実行されていないことを確認する実行可能ファイルを追加します。

次の状況でこのオプションを無効にするには、このパラメーターを $false に設定します。

• Remove-CMDeploymentTypeInstallBehavior コマンドレットを使用してすべての実行可能ファイルを削除する場合
• デプロイで実行されている実行可能ファイルを確認する必要はありません。

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

-AvailableDateTime

このデプロイが使用可能な場合の DateTime オブジェクトを指定 します。 このオブジェクトを取得するには、 Get-Date 組み込みコマンドレットを使用します。

DeadlineDateTime を使用して、デプロイの割り当てまたは期限を指定します。

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

-Collection

アプリケーションをデプロイするコレクション オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMCollection コマンドレットを 使用します。

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

-CollectionId

アプリケーションをデプロイするコレクションの ID を指定します。 たとえば、「 "SMS00004" 」のように入力します。

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

-CollectionName

アプリケーションをデプロイするコレクションの名前を指定します。

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

-Comment

デプロイの省略可能なコメントを指定します。

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

-Confirm

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

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

-CreateAlertBaseOnPercentFailure

デプロイに失敗したアプリケーションの割合に対してアラートを作成するかどうかを示します。 パーセンテージ値を指定するには、 FailParameterValue パラメーターを使用します。

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

-CreateAlertBaseOnPercentSuccess

正常にデプロイされたアプリケーションの割合に対してアラートを作成するかどうかを示します。 パーセンテージ値を指定するには、 SuccessParameterValue パラメーターを使用します。

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

-DeadlineDateTime

このデプロイを割り当てるときに DateTime オブジェクト (期限とも呼ばれます) を指定 します。 このオブジェクトを取得するには、 Get-Date 組み込みコマンドレットを使用します。

-AvailableDateTime を使用して、デプロイを使用できるタイミングを指定します。

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

-DisableWildcardHandling

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

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

-EnableMomAlert

このデプロイで System Center Operations Manager メンテナンス モードを有効にするには、このパラメーターを $true に設定します。

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

-EnableSoftDeadline

遅延適用を有効にするには、このパラメーターを $true に設定します。

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

-FailParameterValue

アラートの原因となるアプリケーションのインストールに失敗した割合を指定します。 1 ~ 100 の整数を指定します。 このアラートを有効にするには、 CreateAlertBaseOnPercentFailure パラメーターを $True に設定します。

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

-ForceWildcardHandling

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

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

-InputObject

構成するアプリケーション デプロイ オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMApplicationDeployment コマンドレットを 使用します。

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

-OverrideServiceWindow

メンテナンス期間外にスケジュールされている場合でも、デプロイが実行されるかどうかを示します。 メンテナンス期間は、コンピューターのメンテナンスと更新に使用される指定された期間です。 この値が $Trueの場合、スケジュールされた時間がメンテナンス期間外であっても、Configuration Manager によってアプリケーションがデプロイされます。 この値が $Falseされている場合、Configuration Manager はウィンドウの外部にアプリケーションをデプロイしません。 使用可能なウィンドウにデプロイできるようになるまで待機します。

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

-PassThru

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

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

-PersistOnWriteFilterDevice

埋め込みデバイスの書き込みフィルターを有効にするかどうかを示します。 $Trueの値の場合、デバイスはメンテナンス期間中に変更をコミットします。 この操作には再起動が必要です。 $Falseの値の場合、デバイスはオーバーレイに変更を保存し、後でコミットします。

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

-PostponeDateTime

CreateAlertBaseOnPercentSuccess を $true に設定する場合は、このパラメーターを使用して DateTime オブジェクトを指定します。 Configuration Manager では、この日付以降にしきい値が SuccessParameterValue より低い場合に、デプロイ アラートが作成されます。

このオブジェクトを取得するには、 Get-Date 組み込みコマンドレットを使用します。

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

-PreDeploy

ユーザーのプライマリ デバイスにアプリケーションを事前にデプロイするかどうかを示します。

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

-RaiseMomAlertsOnFailure

クライアントがアプリケーションのインストールに失敗した場合に Operations Manager アラートを作成するかどうかを示します。

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

-RebootOutsideServiceWindow

メンテナンス期間外にコンピューターを再起動するかどうかを示します。 メンテナンス期間は、コンピューターのメンテナンスと更新に使用される指定された期間です。 この値が $True場合、メンテナンス期間に関係なく、必要な再起動が行われます。 この値が $Falseされている場合、コンピューターはメンテナンス期間外に再起動されません。

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

-ReplaceToastNotificationWithDialog

クライアントで必要なソフトウェアが使用可能な場合は、既定のトースト通知をダイアログ ウィンドウに置き換えるには、このパラメーターを $true に設定します。 既定では false です。 詳細については、「 トースト通知をダイアログ ウィンドウに置き換える」を参照してください。

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

-RequireApproval

このパラメーターを $true に設定した場合、管理者はデバイスでこのアプリケーションの要求を承認する必要があります。

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

-SendWakeUpPacket

展開が開始される前にウェイクアップ パケットをコンピューターに送信するかどうかを示します。 この値が $Trueされている場合、Configuration Manager はコンピューターのスリープ解除を試みます。 この値が $Falseされている場合、コンピューターはスリープ状態から復帰しません。 コンピューターをスリープ解除するには、まず Wake On LAN を構成する必要があります。

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

-SuccessParameterValue

アラートを発生させるアプリケーションの正常なインストールの割合を指定します。 0 から 99 までの整数を指定します。 このアラートを有効にするには、 CreateAlertBaseOnPercentSuccess パラメーターを $Trueとして設定します。

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

-TimeBaseOn

使用するタイム ゾーンを指定します。

• LocalTime: ローカル時刻を使用します。
• UTC: 協定世界時 (UTC) を使用します。

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

-UseMeteredNetwork

期限後に従量制課金インターネット接続経由でクライアントがコンテンツをダウンロードできるようにするかどうかを示します。これにより、余分な費用が発生する可能性があります。

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

-UserNotification

ユーザー通知の種類を指定します。

• DisplayAll: ソフトウェア センターに表示し、すべての通知を表示します。
• DisplaySoftwareCenterOnly: ソフトウェア センターに表示し、コンピューターの再起動の通知のみを表示します。
• HideAll: ソフトウェア センターとすべての通知で非表示にします。

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

メモ

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

関連リンク

• Get-CMApplication
• Get-CMApplicationDeployment
• New-CMApplicationDeployment
• Remove-CMApplicationDeployment
• Configuration Manager を使用してアプリケーションをデプロイする