Set-CMApplicationGroupDeployment

モジュール:

ConfigurationManager

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

構文

Set-CMApplicationGroupDeployment
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-TimeBaseOn <TimeType>]
   -InputObject <IResultObject>
   [-AvailableDateTime <DateTime>]
   [-UserNotification <UserNotificationType>]
   [-EnableMomAlert <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroupDeployment
   -ApplicationGroudId <String>
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-TimeBaseOn <TimeType>]
   [-AvailableDateTime <DateTime>]
   [-UserNotification <UserNotificationType>]
   [-EnableMomAlert <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroupDeployment
   -ApplicationGroupName <String>
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-TimeBaseOn <TimeType>]
   [-AvailableDateTime <DateTime>]
   [-UserNotification <UserNotificationType>]
   [-EnableMomAlert <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

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

注:

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

例

例 1

$collection = Get-CMCollection -Name "co1"

Set-CMApplicationGroupDeployment -ApplicationGroupName "appGroupTest" -Collection $collection -Comment "modify comment"

パラメーター

-ApplicationGroudId

構成するアプリ グループの ID を指定します。

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

-ApplicationGroupName

構成するアプリ グループの名前を指定します。

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

-AvailableDateTime

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

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

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

-Collection

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

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

-CollectionId

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

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

-CollectionName

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

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

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

-DeadlineDateTime

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

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

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

このデプロイで System Center Operations Manager メンテナンス モードを有効にするには、このパラメーターを に $true 設定します。

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

-InputObject

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

Type:	IResultObject
Aliases:	ApplicationGroup, DeploymentSummary, ApplicationGroupAssignment
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-OverrideServiceWindow

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

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

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

-RaiseMomAlertsOnFailure

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

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

-RebootOutsideServiceWindow

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

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

IResultObject

メモ

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

関連リンク

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