New-CMAutoDeploymentRuleDeployment
Cree una implementación para una regla de implementación automática.
Syntax
New-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-Name] <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-Id] <Int32>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-InputObject] <IResultObject>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet New-CMAutoDeploymentRuleDeployment crea una implementación para una regla de implementación automática (ADR).
Nota
Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>
. Para obtener más información, vea getting started.
Ejemplos
Ejemplo 1: Crear una implementación para una regla de implementación automática por su nombre
Este comando crea una implementación para la regla de implementación automática TestDepRule01 y la colección All Systems.
New-CMAutoDeploymentRuleDeployment -Name "TestDepRule01" -CollectionName "All Systems" -EnableDeployment $true -SendWakeupPacket $false -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $false -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $false -AllowRestart $false -SuppressRestartServer $false -SuppressRestartWorkstation $false -WriteFilterHandling $false -GenerateSuccessAlert $true -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $false -GenerateOperationsManagerAlert $false -NoInstallOnRemote $false -NoInstallOnUnprotected $false -UseBranchCache $false
Ejemplo 2: Crear una implementación para una regla de implementación automática por objeto
Este comando obtiene el objeto de regla de implementación automática denominado TestDepRule02. A continuación, usa el operador de canalización para pasar el objeto a New-CMAutoDeploymentRuleDeployment, que crea una implementación para la regla de implementación automática TestDepRule02 y la colección All Systems.
Get-CMAutoDeploymentRule -Name "TestDepRule02" | New-CMAutoDeploymentRuleDeployment -CollectionName "All Systems" -EnableDeployment $true -SendWakeupPacket $false -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $false -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $false -AllowRestart $false -SuppressRestartServer $false -SuppressRestartWorkstation $false -WriteFilterHandling $false -GenerateSuccessAlert $true -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $false -GenerateOperationsManagerAlert $false -NoInstallOnRemote $false -NoInstallOnUnprotected $false -UseBranchCache $false
Parámetros
- Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertTime
Especifica el número de unidades de tiempo para el desplazamiento desde la fecha límite.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertTimeUnit
Especifica el tipo de unidad de tiempo para el desplazamiento de la fecha límite.
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowDownloadFromMicrosoftUpdate
Use este parámetro para establecer la siguiente opción en la página Descargar Configuración de la configuración de implementación de ADR: si las actualizaciones de software no están disponibles en el punto de distribución en grupos de límites actuales, vecinos o de sitio, descargue el contenido de Actualizaciones de Microsoft .
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowRestart
Indica si se permite realizar un reinicio del sistema fuera de las ventanas de mantenimiento definidas cuando se alcanza la fecha límite de instalación.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSoftwareInstallationOutsideMaintenanceWindow
Indica si la instalación de software se puede realizar fuera de las ventanas de mantenimiento definidas cuando se alcanza la fecha límite de instalación.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowUseMeteredNetwork
Use este parámetro para establecer la siguiente opción en la página Descargar Configuración de la configuración de implementación de ADR: permitir que los clientes en una conexión a Internet con medición descarguen contenido después de la fecha límite de instalación, lo que podría incurrir en costos adicionales
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableImmediately
Indica si las actualizaciones de software están disponibles para instalarse tan pronto como sea posible después de ejecutar la regla.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableTime
Especifica el número de unidades de tiempo para el tiempo disponible del software.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableTimeUnit
Especifica el tipo de unidad de tiempo para el tiempo disponible del software.
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Especifica un objeto de colección de destino para la implementación de actualización de software. Para obtener un objeto de colección, use el cmdlet Get-CMCollection.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Especifica el identificador de la colección de destino para la implementación de actualización de software.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifica el nombre de la colección de destino para la implementación de actualización de software.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineImmediately
Indica si las actualizaciones de software necesarias se instalan tan pronto como sea posible cuando se alcanza la fecha límite.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineTime
Especifica el número de unidades de tiempo para la fecha límite.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineTimeUnit
Especifica el tipo de unidad de tiempo para la fecha límite.
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableOperationsManager
Indica si las alertas de Operations Manager están deshabilitadas mientras se ejecutan actualizaciones de software.
Type: | Boolean |
Aliases: | DisableOperationManager |
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 |
-EnableDeployment
Indica si se habilitará la implementación después de que se ejecute esta regla para el grupo de software asociado. Si se establece en $False
, implemente manualmente el grupo de actualización de software.
Type: | Boolean |
Aliases: | Enable, EnabledAfterCreate, EnableAfterCreate |
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 recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateOperationsManagerAlert
Indica si las alertas de Operations Manager se generan cuando se produce un error en la instalación de una actualización de software.
Type: | Boolean |
Aliases: | GenerateOperationManagerAlert |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateSuccessAlert
Indica si se genera una alerta cuando esta regla se ejecuta correctamente.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifica el identificador de la regla de implementación automática a la que se agregará esta implementación.
Type: | Int32 |
Aliases: | AutoDeploymentID |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifica un objeto de regla de implementación automática al que agregar esta implementación. Para obtener un objeto de regla de implementación automática, use el cmdlet Get-CMSoftwareUpdateAutoDeploymentRule.
Type: | IResultObject |
Aliases: | AutoDeploymentRule |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica el nombre de la regla de implementación automática a la que se agregará esta implementación.
Type: | String |
Aliases: | AutoDeploymentName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoInstallOnRemote
Indica si se van a instalar actualizaciones de software cuando las actualizaciones no están disponibles en ningún punto de distribución remoto.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoInstallOnUnprotected
Indica si se van a instalar actualizaciones de software cuando las actualizaciones no están disponibles en ningún punto de distribución desprotegido.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequirePostRebootFullScan
Use este parámetro para establecer **** la siguiente opción en la página Experiencia del usuario de la configuración de implementación de ADR: si cualquier actualización de esta implementación requiere un reinicio del sistema, ejecuteel ciclo de evaluación de la implementación de actualizaciones después del reinicio .
Type: | Boolean |
Aliases: | RunEvaluationAfterRestart |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
Indica si se va a usar Wake-on-LAN para activar clientes para las implementaciones necesarias.
Type: | Boolean |
Aliases: | EnableWakeOnLan |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftDeadlineEnabled
Use este parámetro para establecer **** la siguiente opción en la página Programación de implementación de la configuración de implementación ADR: Retrasar la aplicación de esta implementación según las preferencias del usuario, hasta el período de gracia definido en la configuración del cliente .
Type: | Boolean |
Aliases: | DelayEnforcementAndUpToGracePeriod |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuccessPercentage
Especifica el porcentaje como un número entero de cumplimiento del cliente. Cuando el cumplimiento del cliente está por debajo de este porcentaje, se genera una alerta.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuppressRestartServer
Indica si se suprime un reinicio del sistema en los servidores cuando una actualización de software requiere un reinicio del sistema para completar el proceso de instalación.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuppressRestartWorkstation
Indica si se suprime un reinicio del sistema en las estaciones de trabajo cuando una actualización de software requiere un reinicio del sistema para completar el proceso de instalación.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseBranchCache
Indica si los clientes pueden compartir contenido con otros clientes de la misma subred.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
Especifica el comportamiento de notificación de la experiencia visual del usuario.
Type: | UserNotificationOption |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtc
Indica si la programación de esta implementación se evalúa en función de la hora coordinada universal (UTC).
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VerboseLevel
Especifica cuánto detalle de estado reportan los clientes para las implementaciones creadas por esta regla.
Type: | VerboseLevelType |
Accepted values: | OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages |
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: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WriteFilterHandling
Indica si los cambios se confirman en la fecha límite o durante una ventana de mantenimiento (requiere reinicios). Si se establece en $False
, el contenido se aplica a la superposición y se confirma más adelante.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
IResultObject