New-CMApplicationGroupDeployment

  • Référence
Module:
ConfigurationManager

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

Syntax

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

Description

Créez un déploiement pour un groupe d’applications. Un groupe d’applications contient plusieurs applications et les utilisateurs voient le groupe dans le Centre de logiciels comme une seule entité. Pour plus d’informations, voir Créer des groupes d’applications.

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

Notes

Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\> exemple. Pour plus d’informations, voir la mise en place.

Exemples

Exemple 1

$collection = Get-CMCollection -Name "co1"

$distributionPointName = "dp1.contoso.com"

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

Paramètres

- Confirmer

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

- WhatIf

Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AvailableDateTime

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

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

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

-Collection

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

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

-CollectionId

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

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

-CollectionName

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

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

-Comment

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

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

-DeadlineDateTime

Spécifiez un objet DateTime pour le moment où ce déploiement est affecté, également appelé échéance. Pour obtenir cet objet, utilisez la cmdlet intégrée Get-Date.

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

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

-DeployAction

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

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

-DeployPurpose

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

Type:DeployPurposeType
Accepted values:Available, Required
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

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

-DistributeCollectionName

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 accessibles aux clients.

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

-DistributionPointGroupName

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

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

-DistributionPointName

Le site distribue le contenu à ce point de distribution.

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

-EnableMomAlert

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-GenerateScomAlertOnFailure

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

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

-Id

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

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

-InputObject

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

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

-Name

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

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

-OverrideServiceWindow

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

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

-PersistOnWriteFilterDevice

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

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

-RebootOutsideServiceWindow

Définissez ce paramètre pour $true autoriser le redémarrage de l’appareil en dehors d’une fenêtre de maintenance.

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

-SendWakeupPacket

Indique s’il faut envoyer un paquet de veille aux ordinateurs avant le début du déploiement. Si cette valeur est , Configuration Manager veille à $True ce qu’un ordinateur soit en veille. Si cette valeur est , elle n’est pas une veille $False pour les ordinateurs. Pour que les ordinateurs s’ernt, configurez d’abord Wake On LAN.

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

-TimeBaseOn

Spécifiez le fuseau horaire à utiliser :

  • LocalTime: utilisez l’heure locale de l’appareil.
  • UTC: utiliser le temps universel coordonné (UTC).
Type:TimeType
Accepted values:LocalTime, Utc
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseMeteredNetwork

Indique s’il faut autoriser les clients sur une connexion Internet avec limite à télécharger du contenu après la date d’échéance de l’installation, ce qui peut avoir des coûts supplémentaires.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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: affichez dans le Centre logiciel et affichez uniquement les notifications de redémarrage de l’ordinateur.
  • HideAll: Masquer dans le Centre de logiciels et toutes les notifications
Type:UserNotificationType
Accepted values:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject

Notes

Cette cmdlet renvoie l’objet SMS_ApplicationGroupAssignment classe WMI.