New-CMApplicationAutoPhasedDeployment
Use este cmdlet para crear una implementación por fases para una aplicación mediante la generación de dos fases con la misma configuración.
Syntax
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
Use este cmdlet para crear una implementación por fases para una aplicación mediante la generación de dos fases con la misma configuración. El comportamiento de este cmdlet **** es el mismo que el asistente para crear implementación por fases en una aplicación, cuando se selecciona la opción para crear automáticamente una implementación predeterminada de dos fases.
Nota
Antes de crear una implementación por fases, asegúrese de distribuir el contenido de la aplicación a un punto de distribución.
Ejemplos
Ejemplo 1: Crear una implementación por nombre de aplicación
En este ejemplo se crea una nueva implementación por fases de aplicación denominada myDPName para la aplicación 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"
Ejemplo 2: Crear una implementación por objeto de aplicación de entrada
En este ejemplo se crea una nueva implementación por fases de aplicación denominada myPDName para un objeto de aplicación canal.
$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"
Parámetros
- Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Application
Especifique un objeto de aplicación para la implementación por fases.
Type: | IResultObject |
Position: | 1 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ApplicationId
Especifique un identificador de aplicación para la implementación por fases.
Type: | String |
Aliases: | CIId, CI_ID |
Position: | 1 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationName
Especifique un nombre de aplicación para la implementación por fases.
Type: | String |
Aliases: | ApplicationLocalizedDisplayName |
Position: | 1 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BeginCondition
Especifique una opción para iniciar la segunda fase de implementación después del éxito de la primera fase:
AfterPeriod
: Este parámetro es el mismo que la siguiente configuración **** en la página Configuración del asistente para crear implementación por fases en la consola: inicie automáticamente esta fase después de un período de aplazamiento (en días). Si especifica este valor, use DaysAfterPreviousPhaseSuccess para configurar el período de tiempo.Manually
: Este parámetro es el mismo que la siguiente configuración **** en la página Configuración del Asistente para crear implementación por fases en la consola: Inicie manualmente la implementación de la segunda fase.
Type: | BeginConditionType |
Accepted values: | AfterPeriod, Manually |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaOption
Especifique una opción para elegir los criterios de éxito de la primera fase:
Compliance
: Este parámetro es el mismo que el siguiente valor **** de la página Configuración del asistente para crear implementación por fases en la consola: Porcentaje de éxito de implementación. Especifique el valor porcentual con el parámetro CriteriaValue.Number
: Este parámetro es el mismo que la siguiente configuración **** en la página Configuración del asistente para crear implementación por fases en la consola: Número de dispositivos implementados correctamente. Especifique el número de dispositivos con el parámetro CriteriaValue.
Type: | CriteriaType |
Accepted values: | Compliance, Number |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaValue
Este valor entero depende del valor especificado para CriteriaOption:
Compliance
: especifique el porcentajeNumber
: especifique el número de dispositivos
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DaysAfterPreviousPhaseSuccess
Especifique un valor entero para el número de días después del éxito de la primera fase para comenzar la segunda fase. Este parámetro es el mismo que la siguiente configuración **** en la página Configuración del Asistente para crear implementación por fases en la consola: inicie automáticamente esta fase después de un período de aplazamiento (en días).
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineUnit
Especifique el tipo de período de fecha límite. Use este parámetro con DeadlineValue.
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineValue
Este parámetro solo se usa si especifica AfterPeriod
con el parámetro InstallationChoice.
Especifique un valor entero para el período de tiempo de la fecha límite. Utilice el parámetro DeadlineUnit para especificar el tipo de punto: Hours
, , , Days
Weeks
Months
. Este parámetro es el mismo que la siguiente configuración **** en la página Configuración del Asistente para crear implementación por fases en la consola: La instalación es necesaria después de este período de tiempo.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifique una descripción para la implementación por fases de la aplicación.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollection
Especifique un objeto de colección para la primera fase.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollectionId
Especifique un identificador de colección para la primera fase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollectionName
Especifique un nombre de colección para la primera fase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado. No se recomienda. No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallationChoice
Especifique una opción para el comportamiento con respecto al momento en que el software está disponible:
AsSoonAsPossible
: Este parámetro es el mismo que la siguiente configuración **** en la página Configuración del Asistente para crear implementación por fases en la consola: La instalación es necesaria tan pronto como sea posible.AfterPeriod
: Este parámetro es el mismo que la siguiente **** configuración en la página Configuración del asistente para crear implementación por fases en la consola: la instalación es necesaria después de este período de tiempo. Si especifica este valor, use DeadlineUnit y DeadlineValue para configurar el período de tiempo.
Type: | InstallationChoiceType |
Accepted values: | AsSoonAsPossible, AfterPeriod |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique un nombre para la implementación por fases de la aplicación.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollection
Especifique un objeto de colección para la segunda fase.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollectionId
Especifique un identificador de colección para la segunda fase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollectionName
Especifique un nombre de colección para la segunda fase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottlingDays
Especifique un valor entero para el número de días para que este software esté disponible gradualmente. Este parámetro es el mismo que la siguiente configuración **** en la página Configuración del Asistente para crear implementación por fases en la consola: haga que este software esté disponible gradualmente durante este período de tiempo (en días).
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
IResultObject