New-CMApplicationDeployment

モジュール:

ConfigurationManager

アプリケーションのデプロイを作成します。

構文

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InputObject] <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Id] <Int32>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Name] <String>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-CMApplicationDeployment コマンドレットは、アプリケーションのデプロイを作成します。 詳細については、「 Configuration Manager を使用してアプリケーションをデプロイする」を参照してください。

注:

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

例

例 1: アプリケーションをインストールする

このコマンドは、 Visual Studio 2019 の新しいデプロイを コレクション Developers Workstation に作成します。 アプリがインストールされ、必要です。 使用可能な日付と期限は過去と同じ時間であるため、クライアントがこのポリシーを受け取るとすぐにアプリがインストールされます。

New-CMApplicationDeployment -Name "Visual Studio 2019" -AvailableDateTime '01/01/2020 00:00:00' -CollectionName 'Developers Workstation' -DeadlineDateTime '01/01/2020 00:00:00' -DeployAction Install -DeployPurpose Required

パラメーター

-AllowRepairApp

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

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

-ApprovalRequired

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

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

-DeadlineDateTime

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

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

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

-DeployAction

アプリケーションをインストールまたはアンインストールするには、展開アクションを指定します。 競合するデプロイが同じデバイスをターゲットとする場合は、 インストール アクションが優先されます。

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

-DeployPurpose

デプロイの目的を指定します。

• Available: ユーザーはソフトウェア センターにアプリケーションを表示します。 必要に応じてインストールできます。

• Required: クライアントは、設定したスケジュールに従ってアプリを自動的にインストールします。 アプリケーションが非表示になっていない場合、ユーザーはそのデプロイ状態を追跡できます。 また、ソフトウェア センターを使用して、期限前にアプリケーションをインストールすることもできます。

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

-DisableContentDependencyDetection

依存アプリのコンテンツを自動的に配布しないようにするには、このパラメーターを追加します。

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

-DisableWildcardHandling

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

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

-DistributeCollectionName

サイトは、このコレクション名に関連付けられている配布ポイントにコンテンツを配布します。

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

-DistributeContent

最初にアプリ コンテンツを配布する必要がある場合は、このパラメーターを追加します。

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

-DistributionPointGroupName

アプリケーション コンテンツを配布するには、配布ポイント グループの名前を指定します。

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

-DistributionPointName

アプリケーション コンテンツを配布するには、配布ポイントの名前を指定します。

型:	String
配置:	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

-GenerateScomAlertOnFailure

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

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

-Id

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

型:	Int32
Aliases:	CIId, CI_ID, ApplicationId
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

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

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

-Name

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

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

-OverrideServiceWindow

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

型:	Boolean
配置:	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

-RebootOutsideServiceWindow

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

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

-ReplaceToastNotificationWithDialog

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

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

-SendWakeupPacket

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

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

-Simulation

このパラメーターを追加して、デプロイ シミュレーションを作成します。 詳細については、「 Configuration Manager を使用してアプリケーションのデプロイをシミュレートする」を参照してください。

型:	SwitchParameter
配置:	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

-UpdateSupersedence

使用可能な展開の場合は、このパラメーターを使用して、置き換えられたアプリケーションがインストールされているユーザーまたはデバイスをアップグレードするためのインストール期限を指定します。 DeadlineDateTime を使用して特定の時刻を指定します。それ以外の場合は、AvailableDateTime の後にできるだけ早く指定します。

型:	Boolean
配置:	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
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

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