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 を使用してアプリケーションを展開する」を参照してください。

注意

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

例

例 1: アプリケーションのインストール

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

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

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

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

-ApprovalRequired

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

Type:	Boolean
Aliases:	AppRequiresApproval
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:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineDateTime

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

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

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

-DeployAction

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

Type:	DeployActionType
Accepted values:	Install, Uninstall
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeployPurpose

展開の目的を指定します。

• Available: ユーザーがソフトウェア センターにアプリケーションを表示します。 オンデマンドでインストールできます。

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

Type:	DeployPurposeType
Accepted values:	Available, Required
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableContentDependencyDetection

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

Type:	SwitchParameter
Aliases:	DisableDetectAssociatedContentDependencies
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

-DistributeCollectionName

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

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

-DistributeContent

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

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

-DistributionPointGroupName

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

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

-DistributionPointName

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

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

-GenerateScomAlertOnFailure

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

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

-Id

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

Type:	Int32
Aliases:	CIId, CI_ID, ApplicationId
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	IResultObject
Aliases:	Application
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String
Aliases:	LocalizedDisplayName, ApplicationName
Position:	0
Default value:	None
Accept pipeline input:	False
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

-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

-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

-SendWakeupPacket

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

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

-Simulation

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

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

-UpdateSupersedence

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

Type:	Boolean
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:	None
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

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