New-CMApplicationDeployment
アプリケーションのデプロイを作成します。
構文
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