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 コマンドレットを使用して、変更するアプリケーションを取得することもできます。

注:

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

例

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

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

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

パラメーター

-AllowRepairApp

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

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

-ApplicationId

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

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

-ApplicationName

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

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

-AutoCloseExecutable

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

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

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

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

-AvailableDateTime

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

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

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

-Collection

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

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

-CollectionId

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

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

-CollectionName

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

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

-Comment

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

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

-Confirm

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

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

-CreateAlertBaseOnPercentFailure

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

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

-CreateAlertBaseOnPercentSuccess

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

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

-DeadlineDateTime

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

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

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

-DisableWildcardHandling

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

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

-EnableMomAlert

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

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

-EnableSoftDeadline

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

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

-FailParameterValue

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

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

-ForceWildcardHandling

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

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

-InputObject

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

Type:	IResultObject
Aliases:	Application, DeploymentSummary, Assignment
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-OverrideServiceWindow

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

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

-PassThru

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

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

-PersistOnWriteFilterDevice

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

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

-PostponeDateTime

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

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

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

-PreDeploy

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

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

-RaiseMomAlertsOnFailure

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

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

-RebootOutsideServiceWindow

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

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

-ReplaceToastNotificationWithDialog

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

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

-RequireApproval

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

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

-SendWakeUpPacket

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

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

-SuccessParameterValue

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

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

-TimeBaseOn

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

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

Type:	TimeType
Accepted values:	LocalTime, Utc
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseMeteredNetwork

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

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

-UserNotification

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

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

Type:	UserNotificationType
Accepted values:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

メモ

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

関連リンク

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