New-CMSoftwareUpdateAutoPhasedDeployment
Utilisez cette cmdlet pour créer un déploiement par phases pour les mises à jour logicielles en générant deux phases avec les mêmes paramètres.
Syntax
New-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateGroup] <IResultObject>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateGroupId] <String>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateGroupName] <String>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateIds] <String[]>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdateNames] <String[]>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateAutoPhasedDeployment
[-SoftwareUpdates] <IResultObject[]>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Utilisez cette cmdlet pour créer un déploiement par phases pour les mises à jour logicielles en générant deux phases avec les mêmes paramètres. Le comportement de cette cmdlet **** est identique à celui de l’Assistant Création d’un déploiement par phase sur une mise à jour logicielle, lorsque vous sélectionnez l’option de création automatique d’un déploiement à deux phasespar défaut.
Notes
Avant de créer un déploiement par phases, veillez à distribuer le contenu des mises à jour logicielles à un point de distribution.
Exemples
Exemple 1 : Créer un déploiement par nom de mise à jour
Cet exemple crée un déploiement par phases de mise à jour logicielle nommé myDPName pour la mise à jour logicielle myUpdateName.
New-CMSoftwareUpdateAutoPhasedDeployment -SoftwareUpdateName "myUpdateName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
Exemple 2 : Créer un déploiement par objet de mise à jour d’entrée
Cet exemple crée un déploiement par phases de mise à jour logicielle nommé myPDName pour un objet de mise à jour logicielle canalisé.
$myUpdate | New-CMSoftwareUpdateAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
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 |
-AddPhases
Cette cmdlet crée automatiquement deux phases pour les deux collections spécifiées. Vous pouvez également ajouter d’autres phases avec ce paramètre. Spécifiez un tableau de phases. Utilisez New-CMSoftwareUpdatePhase pour créer les phases.
Type: | Phase[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BeginCondition
Spécifiez une option pour commencer la deuxième phase de déploiement après la réussite de la première phase :
AfterPeriod
: ce paramètre est identique au paramètre suivant sur la **** page Paramètres de l’Assistant Création d’un déploiement par phases dans la console : commencez automatiquement cette phase après une période de report (en jours). Si vous spécifiez cette valeur, utilisez DaysAfterPreviousPhaseSuccess pour configurer la période.Manually
: ce paramètre est identique au paramètre suivant sur la **** page Paramètres de l’Assistant Création d’un déploiement par phases dans la console : commencez manuellement le déploiement de la deuxième phase.
Type: | BeginConditionType |
Accepted values: | AfterPeriod, Manually |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaOption
Spécifiez une option pour choisir les critères de réussite de la première phase :
Compliance
: ce paramètre est identique au paramètre suivant sur la **** page Paramètres de l’Assistant Création d’un déploiement par phases dans la console : Pourcentage de réussite du déploiement. Spécifiez la valeur de pourcentage avec le paramètre CriteriaValue.Number
: ce paramètre est identique au paramètre suivant sur la **** page Paramètres de l’Assistant Création d’un déploiement par phases dans la console : Nombre d’appareils déployés avec succès. Spécifiez le nombre d’appareils avec le paramètre CriteriaValue.
Type: | CriteriaType |
Accepted values: | Compliance, Number |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaValue
Cette valeur entière dépend de la valeur que vous spécifiez pour CriteriaOption:
Compliance
: spécifier le pourcentageNumber
: spécifier le nombre d’appareils
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DaysAfterPreviousPhaseSuccess
Spécifiez une valeur d’un nombre total pour le nombre de jours après la réussite de la première phase pour commencer la deuxième phase. Ce paramètre est identique au paramètre suivant sur la **** page Paramètres de l’Assistant Création d’un déploiement par phases dans la console : commencez automatiquement cette phase après une période de report (en jours).
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineUnit
Spécifiez le type de période d’échéance. Utilisez ce paramètre avec DeadlineValue.
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineValue
Ce paramètre est utilisé uniquement si vous spécifiez AfterPeriod
avec le paramètre InstallationChoice.
Spécifiez une valeur de nombres longs pour la période de l’échéance. Utilisez le paramètre DeadlineUnit pour spécifier le type de point : Hours
, , , Days
Weeks
Months
. Ce paramètre est identique au paramètre suivant sur la **** page Paramètres de l’Assistant Création d’un déploiement par phases dans la console : L’installation est requise après cette période.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Spécifiez une description pour le déploiement par phases de mise à jour logicielle.
Type: | String |
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 |
-FirstCollection
Spécifiez un objet de collection pour la première phase.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollectionId
Spécifiez un ID de collection pour la première phase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollectionName
Spécifiez un nom de collection pour la première phase.
Type: | String |
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. Ce n’est pas recommandé. Vous ne pouvez pas la combiner avec DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InsertAtOrder
Si vous utilisez le paramètre AddPhases, utilisez ce paramètre pour déterminer où, dans l’ordre des phases, insérer les phases supplémentaires. Spécifiez un nombre integer avec le numéro de commande.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallationChoice
Spécifiez une option pour le comportement relatif à la mise à disposition du logiciel :
AsSoonAsPossible
: ce paramètre est identique au paramètre suivant sur la **** page Paramètres de l’Assistant Création d’un déploiement par phases dans la console : l’installation est requise dès que possible.AfterPeriod
: ce paramètre est identique au paramètre suivant sur la **** page Paramètres de l’Assistant Création d’un déploiement par phases dans la console : l’installation est requise après cette période. Si vous spécifiez cette valeur, utilisez DeadlineUnit et DeadlineValue pour configurer la période.
Type: | InstallationChoiceType |
Accepted values: | AsSoonAsPossible, AfterPeriod |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifiez un nom pour le déploiement par phases de l’application.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollection
Spécifiez un objet de collection pour la deuxième phase.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollectionId
Spécifiez un ID de collection pour la deuxième phase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollectionName
Spécifiez un nom de collection pour la deuxième phase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateGroup
Spécifiez un objet pour le groupe de mises à jour logicielles.
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SoftwareUpdateGroupId
Spécifiez le groupe de mises à jour logicielles par ID.
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateGroupName
Spécifiez le groupe de mises à jour logicielles par nom.
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateIds
Spécifiez un tableau d’ID de mise à jour logicielle.
Type: | String[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateNames
Spécifiez un tableau de noms de mises à jour logicielles.
Type: | String[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdates
Spécifiez un tableau d’objets de mise à jour logicielle.
Type: | IResultObject[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ThrottlingDays
Spécifiez une valeur d’un nombre total pour le nombre de jours pour rendre progressivement ce logiciel disponible. Ce paramètre est identique au paramètre suivant sur la **** page Paramètres de l’Assistant Création d’un déploiement progressif dans la console : rendre progressivement ce logiciel disponible sur cette période (en jours).
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Sorties
IResultObject