Configuración e implementación de Novedades

Artículo
04/04/2023

Cree una implementación de actualizaciones de software, en Configuration Manager, creando una instancia de la clase WMI de servidor SMS_UpdatesAssignment y rellenando las propiedades.

Para configurar e implementar actualizaciones

Configure una conexión con el proveedor de SMS.
Cree el nuevo objeto de implementación mediante la clase SMS_UpdatesAssignment .
Rellene las nuevas propiedades de implementación.
Guarde la nueva implementación y las propiedades.

Ejemplo

El siguiente método de ejemplo muestra cómo crear una implementación de actualizaciones de software mediante la clase SMS_UpdatesAssignment . Tenga en cuenta que los parámetros del método de ejemplo reflejan ciertas propiedades de SMS_UpdatesAssignment.

Importante

Los métodos siguientes requieren una matriz de los elementos de configuración asignados (CI_IDs). El contenido de actualización de estos CI_IDs ya debe haberse descargado y agregado a un paquete de implementación de actualizaciones.

Para obtener información sobre cómo llamar al código de ejemplo, vea Llamar a fragmentos de código de Configuration Manager.


Sub ConfigureAndDeploySUMUpdates(connection,                             _  
                                  newApplyToSubTargets,                  _  
                                  newArrayAssignedCIs,                   _  
                                  newAssignmentAction,                   _  
                                  newAssignmentDescription,              _  
                                  newAssignmentName,                     _  
                                  newDesiredConfigType,                  _  
                                  newDPLocality,                         _   
                                  newLocaleID,                           _  
                                  newLogComplianceToWinEvent,            _  
                                  newNotifyUser,                         _  
                                  newRaiseMomAlertsOnFailure,            _  
                                  newSendDetailedNonComplianceStatus,    _  
                                  newStartTime,                          _  
                                  newSuppressReboot,                     _  
                                  newTargetCollectionID,                 _  
                                  newUseGMTTimes)  

  ' Create the new deployment object.  
  Set newSUMUpdatesAssignment = connection.Get("SMS_UpdatesAssignment").SpawnInstance_  

  ' Populate the deployment properties.  
  newSUMUpdatesAssignment.ApplyToSubTargets = newApplyToSubTargets  
  newSUMUpdatesAssignment.AssignedCIs = newArrayAssignedCIs  
  newSUMUpdatesAssignment.AssignmentAction = newAssignmentAction  
  newSUMUpdatesAssignment.AssignmentDescription = newAssignmentDescription  
  newSUMUpdatesAssignment.AssignmentName = newAssignmentName  
  newSUMUpdatesAssignment.DesiredConfigType = newDesiredConfigType  
  newSUMUpdatesAssignment.DPLocality = newDPLocality  
  newSUMUpdatesAssignment.LocaleID = newLocaleID  
  newSUMUpdatesAssignment.LogComplianceToWinEvent = newLogComplianceToWinEvent  
  newSUMUpdatesAssignment.NotifyUser = newNotifyUser  
  newSUMUpdatesAssignment.RaiseMomAlertsOnFailure = newRaiseMomAlertsOnFailure  
  newSUMUpdatesAssignment.SendDetailedNonComplianceStatus = newSendDetailedNonComplianceStatus  
  newSUMUpdatesAssignment.StartTime = newStartTime  
  newSUMUpdatesAssignment.SuppressReboot = newSuppressReboot  
  newSUMUpdatesAssignment.TargetCollectionID = newTargetCollectionID  
  newSUMUpdatesAssignment.UseGMTTimes = newUseGMTTimes  

  ' Save the new deployment and properties.  
  newSUMUpdatesAssignment.Put_   

  ' Output the new deployment name.  
  Wscript.Echo "Created new deployment " & newSUMUpdatesAssignment.AssignmentName                    

End Sub


public void ConfigureAndDeploySUMUpdates(WqlConnectionManager connection,  
                                        bool newApplyToSubTargets,  
                                        int[] newArrayAssignedCIs,  
                                        int newAssignmentAction,  
                                        string newAssignmentDescription,  
                                        string newAssignmentName,  
                                        int newDesiredConfigType,  
                                        int newDPLocality,  
                                        int newLocaleID,  
                                        bool newLogComplianceToWinEvent,  
                                        bool newNotifyUser,  
                                        bool newRaiseMomAlertsOnFailure,  
                                        bool newSendDetailedNonComplianceStatus,  
                                        string newStartTime,  
                                        int newSuppressReboot,  
                                        string newTargetCollectionID,  
                                        bool newUseGMTTimes)      
{  
    try  
    {  

        // Create the deployment object.  
        IResultObject newSUMUpdatesAssignment = connection.CreateInstance("SMS_UpdatesAssignment");  

        // Populate new deployment properties.  
        // Note: newTemplateName must be unique.  

        newSUMUpdatesAssignment["ApplyToSubTargets"].BooleanValue = newApplyToSubTargets;  
        newSUMUpdatesAssignment["AssignedCIs"].IntegerArrayValue = newArrayAssignedCIs;  
        newSUMUpdatesAssignment["AssignmentAction"].IntegerValue = newAssignmentAction;  
        newSUMUpdatesAssignment["AssignmentDescription"].StringValue = newAssignmentDescription;         
        newSUMUpdatesAssignment["AssignmentName"].StringValue = newAssignmentName;  
        newSUMUpdatesAssignment["DesiredConfigType"].IntegerValue = newDesiredConfigType;  
        newSUMUpdatesAssignment["DPLocality"].IntegerValue = newDPLocality;  
        newSUMUpdatesAssignment["LocaleID"].IntegerValue = newLocaleID;  
        newSUMUpdatesAssignment["LogComplianceToWinEvent"].BooleanValue = newLogComplianceToWinEvent;  
        newSUMUpdatesAssignment["NotifyUser"].BooleanValue = newNotifyUser;  
        newSUMUpdatesAssignment["RaiseMomAlertsOnFailure"].BooleanValue = newRaiseMomAlertsOnFailure;  
        newSUMUpdatesAssignment["SendDetailedNonComplianceStatus"].BooleanValue = newSendDetailedNonComplianceStatus;  
        newSUMUpdatesAssignment["StartTime"].DateTimeValue = newStartTime;  
        newSUMUpdatesAssignment["SuppressReboot"].IntegerValue = newSuppressReboot;  
        newSUMUpdatesAssignment["TargetCollectionID"].StringValue = newTargetCollectionID;  
        newSUMUpdatesAssignment["UseGMTTimes"].BooleanValue = newUseGMTTimes;  

        // Save new deployment and new deployment properties.  
        newSUMUpdatesAssignment.Put();  

        // Output the new deployment name.  
        Console.WriteLine("Created deployment: " + newAssignmentName);  
    }  

    catch (SmsException ex)  
    {  
        Console.WriteLine("Failed to create newSUMUpdatesAssignment. Error: " + ex.Message);  
        throw;  
    }  
}

El método de ejemplo tiene los parámetros siguientes:

Parámetro	Tipo	Descripción
`Connection`	-Administrado: `WqlConnectionManager` - VBScript: SWbemServices	Una conexión válida al proveedor de SMS.
`newApplyToSubTargets`	-Administrado: `Boolean` -Vbscript: `Boolean`	Determina si la implementación se aplica a los subtargets. -Verdad -Falso
`newArrayAssignedCIs`	- Administrado: `Integer` matriz - VBScript: `Integer` matriz	Matriz de los elementos de configuración asignados (CI_IDs). El contenido de actualización de estos CI_IDs ya debe haberse descargado y agregado a un paquete de implementación de actualizaciones.
`newAssignmentAction`	-Administrado: `Integer` -Vbscript: `Integer`	Nueva acción de asignación.
`newAssignmentDescription`	-Administrado: `String` -Vbscript: `String`	Descripción de la nueva asignación.
`newAssignmentName`	-Administrado: `String` -Vbscript: `String`	Nuevo nombre de asignación.
`newDesiredConfigType`	-Administrado: `Integer` -Vbscript: `Integer`	Nuevo tipo de configuración deseado.
`newDPLocality`	-Administrado: `Integer` -Vbscript: `Integer`	Nueva localidad de punto de distribución.
`newLocaleID`	-Administrado: `Integer` -Vbscript: `Integer`	Nuevo identificador de configuración regional.
`newLogComplianceToWinEvent`	-Administrado: `Boolean` -Vbscript: `Boolean`	Determina si el cumplimiento se registra en el registro de eventos de Windows. -Verdad -Falso
`newNotifyUser`	-Administrado: `Boolean` -Vbscript: `Boolean`	Identifica si se notifica a los usuarios. -Verdad -Falso
`newRaiseMomAlertsOnFailure`	-Administrado: `Boolean` -Vbscript: `Boolean`	Identifica si las alertas MOM se generan en caso de error. -Verdad -Falso
`newSendDetailedNonComplianceStatus`	-Administrado: `Boolean` -Vbscript: `Boolean`	Identifica si se envía el estado detallado de no conformidad. -Verdad -Falso
`newStartTime`	-Administrado: `String` -Vbscript: `String`	La nueva hora de inicio.
`newSuppressReboot`	-Administrado: `Integer` -Vbscript: `Integer`	Identifica si se suprime el reinicio.
`newTargetCollectionID`	-Administrado: `String` -Vbscript: `String`	Los nuevos identificadores de la colección de destino.
`newUseGMTTimes`	-Administrado: `Boolean` -Vbscript: `Boolean`	Identifica si se va a usar la hora universal coordinada (UTC). -Verdad -Falso

Compilar el código

Este ejemplo de C# requiere:

Espacios de nombres

System

System.Collections.Generic

System.Text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Ensamblado

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

Programación sólida

Para obtener más información sobre el control de errores, consulte Acerca de los errores de Configuration Manager.

Seguridad de .NET Framework

Para obtener más información sobre la protección de aplicaciones Configuration Manager, consulte Configuration Manager administración basada en roles.

Vea también

Información de la implementación de actualizaciones de software

SMS_UpdatesAssignment

Compartir a través de