Start-CMApplicationDeployment

モジュール:

ConfigurationManager

(非推奨)Configuration Managerでアプリケーションのデプロイを開始します。

構文

Start-CMApplicationDeployment
     [-ApprovalRequired <Boolean>]
     [-AvailableDate <DateTime>]
     [-AvailableDateTime <DateTime>]
     [-AvailableTime <DateTime>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeadlineDate <DateTime>]
     [-DeadlineDateTime <DateTime>]
     [-DeadlineTime <DateTime>]
     [-DeployAction <DeployActionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-EnableMomAlert <Boolean>]
     [-FailParameterValue <Int32>]
     [-GenerateScomAlertOnFailure <Boolean>]
     [-InputObject] <IResultObject>
     [-OverrideServiceWindow <Boolean>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-PostponeDate <DateTime>]
     [-PostponeDateTime <DateTime>]
     [-PostponeTime <DateTime>]
     [-PreDeploy <Boolean>]
     [-RebootOutsideServiceWindow <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SuccessParameterValue <Int32>]
     [-TimeBaseOn <TimeType>]
     [-UpdateSupersedence <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMApplicationDeployment
     [-ApprovalRequired <Boolean>]
     [-AvailableDate <DateTime>]
     [-AvailableDateTime <DateTime>]
     [-AvailableTime <DateTime>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeadlineDate <DateTime>]
     [-DeadlineDateTime <DateTime>]
     [-DeadlineTime <DateTime>]
     [-DeployAction <DeployActionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-EnableMomAlert <Boolean>]
     [-FailParameterValue <Int32>]
     [-GenerateScomAlertOnFailure <Boolean>]
     [-Id] <Int32>
     [-OverrideServiceWindow <Boolean>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-PostponeDate <DateTime>]
     [-PostponeDateTime <DateTime>]
     [-PostponeTime <DateTime>]
     [-PreDeploy <Boolean>]
     [-RebootOutsideServiceWindow <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SuccessParameterValue <Int32>]
     [-TimeBaseOn <TimeType>]
     [-UpdateSupersedence <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMApplicationDeployment
     [-ApprovalRequired <Boolean>]
     [-AvailableDate <DateTime>]
     [-AvailableDateTime <DateTime>]
     [-AvailableTime <DateTime>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeadlineDate <DateTime>]
     [-DeadlineDateTime <DateTime>]
     [-DeadlineTime <DateTime>]
     [-DeployAction <DeployActionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-EnableMomAlert <Boolean>]
     [-FailParameterValue <Int32>]
     [-GenerateScomAlertOnFailure <Boolean>]
     [-Name] <String>
     [-OverrideServiceWindow <Boolean>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-PostponeDate <DateTime>]
     [-PostponeDateTime <DateTime>]
     [-PostponeTime <DateTime>]
     [-PreDeploy <Boolean>]
     [-RebootOutsideServiceWindow <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SuccessParameterValue <Int32>]
     [-TimeBaseOn <TimeType>]
     [-UpdateSupersedence <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

重要

[!メモ] このコマンドレットは廃止されました。 代わりに New-CMApplicationDeployment を 使用します。

Start-CMApplicationDeployment コマンドレットは、アプリケーションのデプロイを開始します。

注:

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

例

例 1: アプリケーションのデプロイを開始する

PS XYZ:\> Start-CMApplicationDeployment -CollectionName "All Users" -Name "7zip" -AvaliableDate 2012/10/1 -AvaliableTime 12:45 -Comment "test" -DeadlineDate 2013/10/23 -DeadlineTime 21:12 -DeployAction Uninstall -EnableMomAlert $True -FailParameterValue 40 -OverrideServiceWindow $True -PersistOnWriteFilterDevice $False -PostponeDate 2014/2/8 -PostponeTime 11:11 -PreDeploy $True -RaiseMomAlertsOnFailure $True -RebootOutsideServiceWindow $True -SendWakeUpPacket $True -SuccessParameterValue 30 -UseMeteredNetwork $True -UserNotification DisplaySoftwareCenterOnly

このコマンドは、7zip という名前のアプリケーションデプロイを開始します。

パラメーター

-ApprovalRequired

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

-AvailableDate

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

-AvailableDateTime

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

-AvailableTime

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

-CollectionName

このアプリケーションをデプロイするターゲット コレクションを指定します。

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

-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

-DeadlineDate

アプリケーションをインストールする日を指定します。 自動インストールは、アプリケーションがインストールされていない場合にインストールを実行します。

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

-DeadlineDateTime

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

-DeadlineTime

アプリケーションをインストールする時間を指定します。 自動インストールは、アプリケーションがインストールされていない場合にインストールを実行します。

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

-DeployAction

デプロイのアクションを指定します。 有効な値は次のとおりです。

• インストール。 アプリケーションをインストールします。

• アンインストール。 アプリケーションをアンインストールします。

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

-DeployPurpose

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

有効な値は次のとおりです。

• 利用 可能。 ターゲット コレクションがデバイス コレクションの場合、アプリケーションはソフトウェア センターで使用できます。 ターゲット コレクションがユーザー コレクションの場合、アプリケーションはカタログ Web サイトで使用できます。

• 必須です。 インストールは、期限が過ぎると発生します。

Type:	DeployPurposeType
Accepted values:	Available, Required
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

Operations Manager メンテナンス モードを有効にするかどうかを示します。

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

-FailParameterValue

超過した場合にデプロイ アラートを生成する値を指定します。

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

-GenerateScomAlertOnFailure

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

-Id

ID の配列を指定します。

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

-InputObject

アプリケーションデプロイオブジェクトを指定します。

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

-Name

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

Type:	String
Aliases:	LocalizedDisplayName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-OverrideServiceWindow

メンテナンス期間外にアプリケーションのインストールが行われるかどうかを示します。

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

期限またはメンテナンス期間中に Windows Embedded デバイスで変更をコミットするかどうかを示します。 それ以外の場合、変更はオーバーレイに書き込まれ、後でコミットされます。

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

-PostponeDate

アラートを作成する日付を指定します。

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

-PostponeDateTime

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

-PostponeTime

アラートを作成する時間を指定します。

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

-PreDeploy

インストール前にソフトウェアをデバイスにコピーするかどうかを示します。 このパラメーターを使用するには、 DeployPurpose パラメーターを Required に設定します。

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

-SendWakeupPacket

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

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

-SuccessParameterValue

アラートを作成する前にしきい値を超える必要がある値を指定します。

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

-UpdateSupersedence

{{ Fill UpdateSupersedence Description }}

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

出力

System.Object

関連リンク

• Set-CMApplicationDeployment