New-CMAutoDeploymentRuleDeployment

Referencia

Módulo:: ConfigurationManager

Cree una implementación para una regla de implementación automática.

Sintaxis

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 cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Creación de una implementación para una regla de implementación automática por 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: Creación de 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

-AlertTime

Especifica el número de unidades de tiempo para el desplazamiento desde la fecha límite.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AlertTimeUnit

Especifica el tipo de unidad de tiempo para el desplazamiento de la fecha límite.

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

-AllowDownloadFromMicrosoftUpdate

Use este parámetro para establecer la siguiente opción en la página Configuración de descarga de la configuración de implementación de ADR: si las actualizaciones de software no están disponibles en el punto de distribución de los grupos de límites actuales, vecinos o de sitio, descargue el contenido de Actualizaciones de Microsoft.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AllowSoftwareInstallationOutsideMaintenanceWindow

Indica si se permite la instalación de software fuera de las ventanas de mantenimiento definidas cuando se alcanza la fecha límite de instalación.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AllowUseMeteredNetwork

Use este parámetro para establecer la siguiente opción en la página Configuración de descarga de la configuración de implementación de ADR: Permitir que los clientes de una conexión a Internet de uso medido descarguen contenido después de la fecha límite de instalación, lo que podría incurrir en costos adicionales.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AvailableImmediately

Indica si las actualizaciones de software están disponibles para instalarse lo antes posible después de ejecutar la regla.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AvailableTime

Especifica el número de unidades de tiempo para el tiempo disponible del software.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AvailableTimeUnit

Especifica el tipo de unidad de tiempo para la hora disponible del software.

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

-Collection

Especifica un objeto de colección de destino para la implementación de actualizaciones de software. Para obtener un objeto de colección, use el cmdlet Get-CMCollection .

Tipo:	IResultObject
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CollectionId

Especifica el identificador de la colección de destino para la implementación de actualizaciones de software.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CollectionName

Especifica el nombre de la colección de destino para la implementación de actualizaciones de software.

Tipo:	String
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:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DeadlineImmediately

Indica si las actualizaciones de software necesarias se instalan lo antes posible cuando se alcanza la fecha límite.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DeadlineTime

Especifica el número de unidades de tiempo para la fecha límite.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DeadlineTimeUnit

Especifica el tipo de unidad de tiempo para la fecha límite.

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

-DisableOperationsManager

Indica si las alertas de Operations Manager están deshabilitadas mientras se ejecutan las actualizaciones de software.

Tipo:	Boolean
Alias:	DisableOperationManager
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

-EnableDeployment

Indica si se va a 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 actualizaciones de software.

Tipo:	Boolean
Alias:	Enable, EnabledAfterCreate, EnableAfterCreate
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 recomendado). 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

-GenerateOperationsManagerAlert

Indica si se generan alertas de Operations Manager cuando se produce un error en la instalación de una actualización de software.

Tipo:	Boolean
Alias:	GenerateOperationManagerAlert
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-GenerateSuccessAlert

Indica si se genera una alerta cuando esta regla se ejecuta correctamente.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Id

Especifica el identificador de la regla de implementación automática a la que se va a agregar esta implementación.

Tipo:	Int32
Alias:	AutoDeploymentID
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 .

Tipo:	IResultObject
Alias:	AutoDeploymentRule
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Especifica el nombre de la regla de implementación automática a la que se va a agregar esta implementación.

Tipo:	String
Alias:	AutoDeploymentName
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NoInstallOnRemote

Indica si se deben instalar actualizaciones de software cuando las actualizaciones no están disponibles en ningún punto de distribución remoto.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NoInstallOnUnprotected

Indica si se deben instalar actualizaciones de software cuando las actualizaciones no están disponibles en puntos de distribución no protegidos.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 alguna actualización de esta implementación requiere un reinicio del sistema, ejecute el ciclo de evaluación de la implementación de actualizaciones después del reinicio.

Tipo:	Boolean
Alias:	RunEvaluationAfterRestart
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SendWakeupPacket

Indica si se debe usar Wake-on-LAN para reactivar clientes para las implementaciones necesarias.

Tipo:	Boolean
Alias:	EnableWakeOnLan
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 de ADR: Retrasar el cumplimiento de esta implementación según las preferencias del usuario, hasta el período de gracia definido en la configuración del cliente.

Tipo:	Boolean
Alias:	DelayEnforcementAndUpToGracePeriod
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SuccessPercentage

Especifica el porcentaje como un entero de cumplimiento del cliente. Cuando el cumplimiento del cliente está por debajo de este porcentaje, se genera una alerta.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SuppressRestartServer

Indica si un reinicio del sistema se suprime en los servidores cuando una actualización de software requiere un reinicio del sistema para completar el proceso de instalación.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SuppressRestartWorkstation

Indica si un reinicio del sistema se suprime en las estaciones de trabajo cuando una actualización de software requiere un reinicio del sistema para completar el proceso de instalación.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UseBranchCache

Indica si los clientes pueden compartir contenido con otros clientes de la misma subred.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UserNotification

Especifica el comportamiento de notificación de la experiencia visual del usuario.

Tipo:	UserNotificationOption
Valores aceptados:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UseUtc

Indica si la programación de esta implementación se evalúa en función de la hora universal coordinada (UTC).

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-VerboseLevel

Especifica la cantidad de detalles de estado que los clientes notifican para las implementaciones creadas por esta regla.

Tipo:	VerboseLevelType
Valores aceptados:	OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
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:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Boolean
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

Compartir a través de