Partager via

New-CMApplicationAutoPhasedDeployment

  • Référence
Module:
ConfigurationManager

Utilisez cette applet de commande pour créer un déploiement par phases pour une application en générant deux phases avec les mêmes paramètres.

Syntaxe

New-CMApplicationAutoPhasedDeployment
   [-Application] <IResultObject>
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMApplicationAutoPhasedDeployment
   [-ApplicationId] <String>
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMApplicationAutoPhasedDeployment
   [-ApplicationName] <String>
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer un déploiement par phases pour une application en générant deux phases avec les mêmes paramètres. Le comportement de cette applet de commande est le même que celui de l’Assistant Création d’un déploiement par phases sur une application, lorsque vous sélectionnez l’option Créer automatiquement un déploiement en deux phases par défaut.

Remarque

Avant de créer un déploiement par phases, veillez à distribuer le contenu de l’application à un point de distribution.

Exemples

Exemple 1 : Créer un déploiement par nom d’application

Cet exemple crée un déploiement progressif d’application nommé myDPName pour l’application myApp.

New-CMApplicationAutoPhasedDeployment -ApplicationName "myApp" -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 d’application d’entrée

Cet exemple crée un déploiement par phases d’application nommé myPDName pour un objet d’application redirigé.

$myApp | New-CMApplicationAutoPhasedDeployment -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

-Application

Spécifiez un objet d’application pour le déploiement par phases.

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

-ApplicationId

Spécifiez un ID d’application pour le déploiement par phases.

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

-ApplicationName

Spécifiez un nom d’application pour le déploiement par phases.

Type:String
Alias:ApplicationLocalizedDisplayName
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 dans 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 dans 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
Valeurs acceptées:AfterPeriod, Manually
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

-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 dans 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 dans la page Paramètres de l’Assistant Création d’un déploiement par phases dans la console : Nombre d’appareils correctement déployés. Spécifiez le nombre d’appareils avec le paramètre CriteriaValue .

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

-CriteriaValue

Cette valeur entière dépend de la valeur que vous spécifiez pour CriteriaOption :

  • Compliance: spécifiez le pourcentage

  • Number: spécifiez le nombre d’appareils

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

-DaysAfterPreviousPhaseSuccess

Spécifiez une valeur entière 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 dans 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeadlineUnit

Spécifiez le type de période d’échéance. Utilisez ce paramètre avec DeadlineValue.

Type:TimeUnitType
Valeurs acceptées:Hours, Days, Weeks, Months
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeadlineValue

Ce paramètre est utilisé uniquement si vous spécifiez AfterPeriod avec le paramètre InstallationChoice .

Spécifiez une valeur entière pour la période de temps 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 dans 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifiez une description pour le déploiement par phases de l’application.

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

-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

-FirstCollection

Spécifiez un objet de collection pour la première phase.

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

-FirstCollectionId

Spécifiez un ID de collection pour la première phase.

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

-FirstCollectionName

Spécifiez un nom de collection pour la première phase.

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

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

-InstallationChoice

Spécifiez une option pour le comportement relatif au moment où le logiciel est mis à disposition :

  • AsSoonAsPossible: Ce paramètre est identique au paramètre suivant dans 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 dans 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
Valeurs acceptées:AsSoonAsPossible, AfterPeriod
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifiez un nom pour le déploiement par phases d’application.

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

-SecondCollection

Spécifiez un objet de collection pour la deuxième phase.

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

-SecondCollectionId

Spécifiez un ID de collection pour la deuxième phase.

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

-SecondCollectionName

Spécifiez un nom de collection pour la deuxième phase.

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

-ThrottlingDays

Spécifiez une valeur entière pour le nombre de jours pour rendre progressivement ce logiciel disponible. Ce paramètre est identique au paramètre suivant dans la page Paramètres de l’Assistant Création d’un déploiement par phases dans la console : Rendre progressivement ce logiciel disponible pendant cette période (en jours).

Type:Int32
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