Set-CMApplicationGroupDeployment

Module:

ConfigurationManager

Configurez le déploiement d’un groupe d’applications.

Syntaxe

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>]

Description

Configurez le déploiement d’un groupe d’applications. Un groupe d’applications contient plusieurs applications, et les utilisateurs voient le groupe dans le Centre logiciel comme une seule entité. Pour plus d’informations, consultez Créer des groupes d’applications.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1

$collection = Get-CMCollection -Name "co1"

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

Paramètres

-ApplicationGroudId

Spécifiez l’ID du groupe d’applications à configurer.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ApplicationGroupName

Spécifiez le nom du groupe d’applications à configurer.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AvailableDateTime

Spécifiez un objet DateTime pour le moment où ce déploiement est disponible. Pour obtenir cet objet, utilisez l’applet de commande intégrée Get-Date .

Utilisez DeadlineDateTime pour spécifier l’affectation ou l’échéance du déploiement.

Type:	DateTime
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Collection

Spécifiez un objet de collection comme cible pour ce déploiement de groupe d’applications. Pour obtenir cet objet, utilisez l’applet de commande Get-CMCollection .

Type:	IResultObject
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-CollectionId

Spécifiez un ID de collection comme cible pour ce déploiement de groupe d’applications.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-CollectionName

Spécifiez un nom de collection comme cible pour ce déploiement de groupe d’applications.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	True

-Comment

Spécifiez un commentaire facultatif pour le déploiement du groupe d’applications.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DeadlineDateTime

Spécifiez un objet DateTime pour le moment où ce déploiement est attribué, également appelé échéance. Pour obtenir cet objet, utilisez l’applet de commande intégrée Get-Date .

Utilisez -AvailableDateTime pour spécifier quand le déploiement est disponible.

Type:	DateTime
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-EnableMomAlert

Définissez ce paramètre sur $true pour activer le mode de maintenance de System Center Operations Manager pour ce déploiement.

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InputObject

Spécifiez un objet pour le groupe d’applications. Pour obtenir cet objet, utilisez l’applet de commande Get-CMApplicationGroup .

Type:	IResultObject
Alias:	ApplicationGroup, DeploymentSummary, ApplicationGroupAssignment
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-OverrideServiceWindow

Définissez ce paramètre sur $true pour installer le groupe d’applications en dehors d’une fenêtre de maintenance.

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PersistOnWriteFilterDevice

Utilisez ce paramètre pour gérer les filtres d’écriture pour les appareils Windows Embedded. Si vous le définissez sur $true, l’appareil valide les modifications à l’échéance ou pendant une fenêtre de maintenance. Cette action nécessite un redémarrage. Si vous le définissez sur $false, l’appareil enregistre les modifications apportées à la superposition temporaire et les valide ultérieurement.

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RaiseMomAlertsOnFailure

Définissez ce paramètre sur $true pour générer une alerte System Center Operations Manager en cas d’échec du déploiement.

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RebootOutsideServiceWindow

Définissez ce paramètre sur $true pour permettre à l’appareil de redémarrer en dehors d’une fenêtre de maintenance.

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TimeBaseOn

Spécifiez le fuseau horaire à utiliser :

• LocalTime: utilisez l’heure locale de l’appareil.
• UTC: utilisez le temps universel coordonné (UTC).

Type:	TimeType
Valeurs acceptées:	LocalTime, Utc
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-UserNotification

Utilisez ce paramètre pour spécifier l’expérience utilisateur pour ce déploiement :

• DisplayAll: Afficher dans le Centre logiciel et afficher toutes les notifications
• DisplaySoftwareCenterOnly: afficher dans le Centre logiciel et afficher uniquement les notifications de redémarrage de l’ordinateur.
• HideAll: Masquer dans le Centre logiciel et toutes les notifications

Type:	UserNotificationType
Valeurs acceptées:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject

IResultObject

Notes

Cette applet de commande retourne l’objet de classe WMI SMS_ApplicationGroupAssignment.

Liens associés

• Get-CMApplicationGroupDeployment
• New-CMApplicationGroupDeployment
• Remove-CMApplicationGroupDeployment
• Get-CMApplicationGroup
• Créer des groupes d’applications