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:\> 。詳細については、「Getting started」を参照してください。

例

例 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
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationId

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

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

-ApplicationName

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

Type:	String
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-AvailableDateTime

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

DeadlineDateTime を使用して、展開の割り当てまたは期限を指定_します_。

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

-Collection

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

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

-CollectionId

アプリケーションを展開するコレクションの ID を指定します。たとえば、"SMS00004" などです。

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

-CollectionName

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

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

-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

-CreateAlertBaseOnPercentFailure

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

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

-CreateAlertBaseOnPercentSuccess

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

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

-DeadlineDateTime

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

-AvailableDateTime を使用して、展開を使用できる時間を指定_します_。

Type:	DateTime
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

-EnableMomAlert

この展開で Operations $true Manager System Centerモードを有効にするには、このパラメーターを設定します。

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

-EnableSoftDeadline

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

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

-FailParameterValue

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

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

-InputObject

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

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

-OverrideServiceWindow

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

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

-PassThru

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

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

-PersistOnWriteFilterDevice

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

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

-PostponeDateTime

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

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

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

-PreDeploy

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

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

-RaiseMomAlertsOnFailure

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

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

-RebootOutsideServiceWindow

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

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

-ReplaceToastNotificationWithDialog

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

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

-RequireApproval

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

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

-SendWakeUpPacket

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

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

-SuccessParameterValue

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

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

-TimeBaseOn

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

LocalTime: 現地時間を使用します。
UTC: 協定世界時 (UTC) を使用します。

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

-UseMeteredNetwork

期限が過ぎた後に、クライアントが有料インターネット接続を使用してコンテンツをダウンロードできるかどうかを示します。追加の費用が発生する可能性があります。

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

-UserNotification

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

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

Type:	UserNotificationType
Accepted values:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

メモ

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

Set-CMApplicationDeployment

構文

説明

例

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

パラメーター

入力

出力

メモ

関連リンク