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.
Sintaxis
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, al seleccionar la opción Crear automáticamente una implementación predeterminada en 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: Creación de 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: Creación de 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 canalizar.
$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
-Application
Especifique un objeto de aplicación para la implementación por fases.
| Tipo: | IResultObject |
| Posición: | 1 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ApplicationId
Especifique un identificador de aplicación para la implementación por fases.
| Tipo: | String |
| Alias: | CIId, CI_ID |
| Posición: | 1 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ApplicationName
Especifique un nombre de aplicación para la implementación por fases.
| Tipo: | String |
| Alias: | ApplicationLocalizedDisplayName |
| Posición: | 1 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-BeginCondition
Especifique una opción para comenzar la segunda fase de la implementación después del éxito de la primera fase:
AfterPeriod: este parámetro es el mismo que el siguiente en la página Configuración del Asistente para crear implementación por fases en la consola: comience 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 el siguiente en la página Configuración del Asistente para crear implementación por fases en la consola: comience manualmente la implementación de la segunda fase.
| Tipo: | BeginConditionType |
| Valores aceptados: | AfterPeriod, Manually |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 en la página Configuración del Asistente para crear implementación por fases en la consola: Porcentaje de éxito de la implementación. Especifique el valor de porcentaje con el parámetro CriteriaValue .Number: este parámetro es el mismo que el siguiente 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 .
| Tipo: | CriteriaType |
| Valores aceptados: | Compliance, Number |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-CriteriaValue
Este valor entero depende del valor que especifique para CriteriaOption:
Compliance: especifique el porcentaje.Number: especifique el número de dispositivos.
| Tipo: | Int32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 el siguiente en la página Configuración del Asistente para crear implementación por fases en la consola: comience automáticamente esta fase después de un período de aplazamiento (en días).
| Tipo: | Int32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DeadlineUnit
Especifique el tipo de período de fecha límite. Use este parámetro con DeadlineValue.
| Tipo: | TimeUnitType |
| Valores aceptados: | Hours, Days, Weeks, Months |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DeadlineValue
Este parámetro solo se usa si se especifica AfterPeriod con el parámetro InstallationChoice .
Especifique un valor entero para el período de tiempo de la fecha límite. Use el parámetro DeadlineUnit para especificar el tipo de período: Hours, Days, Weeks, Months. Este parámetro es el mismo que el siguiente 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.
| Tipo: | Int32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Description
Especifique una descripción para la implementación por fases de la aplicación.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-FirstCollection
Especifique un objeto de colección para la primera fase.
| Tipo: | IResultObject |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-FirstCollectionId
Especifique un identificador de colección para la primera fase.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-FirstCollectionName
Especifique un nombre de colección para la primera fase.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado. No se recomienda. No se puede combinar con DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-InstallationChoice
Especifique una opción para el comportamiento relativo a cuando el software esté disponible:
AsSoonAsPossible: este parámetro es el mismo que el siguiente en la página Configuración del Asistente para crear implementación por fases en la consola: La instalación es necesaria lo antes posible.AfterPeriod: este parámetro es el mismo que el siguiente 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.
| Tipo: | InstallationChoiceType |
| Valores aceptados: | AsSoonAsPossible, AfterPeriod |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Name
Especifique un nombre para la implementación por fases de la aplicación.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-SecondCollection
Especifique un objeto de colección para la segunda fase.
| Tipo: | IResultObject |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-SecondCollectionId
Especifique un identificador de colección para la segunda fase.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-SecondCollectionName
Especifique un nombre de colección para la segunda fase.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 el siguiente 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).
| Tipo: | Int32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
IResultObject