New-CMApplicationGroupDeployment

モジュール:

ConfigurationManager

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

構文

New-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InputObject] <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Id] <Int32>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Name] <String>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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>]

説明

アプリケーション グループのデプロイを作成します。 アプリ グループには複数のアプリケーションが含まれており、ユーザーはソフトウェア センターのグループを 1 つのエンティティとして表示します。 詳細については、「 アプリケーション グループの作成」を参照してください。

アプリ グループをデプロイする前に、アプリ グループを作成する必要があります。 その後、1 つの展開としてユーザーまたはデバイス コレクションに展開できます。

注:

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

例

例 1

$collection = Get-CMCollection -Name "co1"

$distributionPointName = "dp1.contoso.com"

New-CMApplicationGroupDeployment -Id 16777536 -Collection $collection -DistributionPointName $distributionPointName -DistributeContent

パラメーター

-AvailableDateTime

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

DeadlineDateTime を使用して、デプロイの割り当てまたは期限を指定します。

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

-Collection

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

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

-CollectionId

このアプリ グループのデプロイのターゲットとしてコレクション ID を指定します。

型:	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

このデプロイをユーザーがインストールできるか、期限にインストールする必要があるかを指定します。

型:	DeployPurposeType
指定可能な値:	Available, Required
配置:	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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

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

-GenerateScomAlertOnFailure

デプロイが失敗したときに System Center Operations Manager アラートを生成するには、このパラメーターを $true に設定します。

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

-Id

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

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

-InputObject

アプリ グループのオブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMApplicationGroup コマンドレットを 使用します。

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

-Name

このアプリ グループのデプロイの名前を指定します。

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

-OverrideServiceWindow

メンテナンス期間外にアプリ グループをインストールするには、このパラメーターを $true に設定します。

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

-PersistOnWriteFilterDevice

Windows Embedded デバイスの書き込みフィルターを処理するには、このパラメーターを使用します。 $trueに設定すると、期限またはメンテナンス期間中に変更がコミットされます。 この操作には再起動が必要です。 $falseに設定すると、デバイスは一時オーバーレイへの変更を保存し、後でコミットします。

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

-RebootOutsideServiceWindow

このパラメーターを $true に設定して、メンテナンス期間外にデバイスを再起動できるようにします。

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

-SendWakeupPacket

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

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

-TimeBaseOn

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

• LocalTime: デバイスのローカル時刻を使用します。
• UTC: 協定世界時 (UTC) を使用します。

型:	TimeType
指定可能な値:	LocalTime, Utc
配置:	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

出力

IResultObject

メモ

このコマンドレットは、SMS_APPLICATIONGROUPASSIGNMENT WMI クラス オブジェクトを返します。

関連リンク

• Get-CMApplicationGroupDeployment
• Remove-CMApplicationGroupDeployment
• Set-CMApplicationGroupDeployment
• Get-CMApplicationGroup
• アプリケーション グループを作成する