New-CMApplicationGroupDeployment

Module:

ConfigurationManager

Créer un déploiement pour un groupe d’applications.

Syntaxe

PowerShell

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

PowerShell

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

PowerShell

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

Description

Créer un déploiement pour 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.

Avant de pouvoir déployer un groupe d’applications, vous devez le créer. Vous pouvez ensuite le déployer sur un regroupement d’utilisateurs ou d’appareils en tant que déploiement unique.

Notes

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

PowerShell

$collection = Get-CMCollection -Name "co1"

$distributionPointName = "dp1.contoso.com"

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

Paramètres

-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
Alias:	SupersedenceDeadlineDateTime
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DeployAction

Spécifiez si ce déploiement doit installer ou désinstaller le groupe d’applications.

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

-DeployPurpose

Spécifiez si ce déploiement est disponible pour l’installation des utilisateurs ou s’il doit être installé à l’échéance.

Type:	DeployPurposeType
Valeurs acceptées:	Available, Required
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

-DistributeCollectionName

Le site distribue le contenu aux groupes de points de distribution associés à ce nom de collection.

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

-DistributeContent

Ajoutez ce paramètre pour distribuer le contenu du groupe d’applications lorsque vous créez ce déploiement. Les clients ne peuvent pas installer les applications tant que vous n’avez pas distribué le contenu aux points de distribution auxquels les clients peuvent accéder.

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

-DistributionPointGroupName

Le site distribue le contenu à ce groupe de points de distribution.

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

-DistributionPointName

Le site distribue le contenu à ce point de distribution.

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

-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

-GenerateScomAlertOnFailure

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
Alias:	RaiseMomAlertsOnFailure
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Id

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

Type:	Int32
Alias:	CIId, CI_ID, ApplicationGroupId
Position:	0
Valeur par défaut:	None
Obligatoire:	True
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
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Name

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

Type:	String
Alias:	LocalizedDisplayName, ApplicationGroupName
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
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

-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

-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

-SendWakeupPacket

Indique s’il faut envoyer un paquet de mise en éveil aux ordinateurs avant le début du déploiement. Si cette valeur est $True, Configuration Manager met un ordinateur en veille. Si cette valeur est $False, elle ne met pas les ordinateurs en veille. Pour que les ordinateurs sortent, commencez par configurer Wake On LAN.

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

-UseMeteredNetwork

Indique s’il faut autoriser les clients sur une connexion Internet limitée à télécharger du contenu après l’échéance d’installation, ce qui peut entraîner des coûts supplémentaires.

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

-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

Notes

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

Liens associés

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