New-CMApplicationGroupDeployment
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 notificationsDisplaySoftwareCenterOnly
: 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.