Como Configurar e Implementar Atualizações

Artigo
08/12/2021

Cria uma implementação de atualizações de software, no Gestor de Configurações, criando uma instância da classe WMI do SMS_UpdatesAssignment servidor e povoando as propriedades.

Para configurar e implementar atualizações

Configurar uma ligação com o Fornecedor DE SMS.
Crie o novo objeto de implantação utilizando a classe SMS_UpdatesAssignment.
Povoar as novas propriedades de implantação.
Guarde a nova implantação e propriedades.

Exemplo

O método de exemplo a seguir mostra como criar uma implementação de atualizações de software utilizando a classe SMS_UpdatesAssignment. Note que os parâmetros do método exemplo refletem certas propriedades de SMS_UpdatesAssignment .

Importante

Os métodos abaixo requerem uma matriz dos itens de configuração atribuídos (CI_IDs). O conteúdo da atualização destes CI_IDs já deve ter sido descarregado e adicionado a um pacote de implementação de atualizações.

Para obter informações sobre a chamada do código de amostra, consulte o Código de Identificação do Gestor de Chamadas.


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;  
    }  
}

O método exemplo tem os seguintes parâmetros:

Parâmetro	Tipo	Description
`Connection`	- Gerido: `WqlConnectionManager` - VBScript: SWbemServices	Uma ligação válida ao Fornecedor de SMS.
`newApplyToSubTargets`	- Gerido: `Boolean` - VBScript: `Boolean`	Determina se a implantação se aplica a sub-alvos. - Verdade - Falso
`newArrayAssignedCIs`	- Gerido: `Integer` matriz - VBScript: `Integer` matriz	Uma matriz dos itens de configuração atribuídos (CI_IDs). O conteúdo da atualização destes CI_IDs já deve ter sido descarregado e adicionado a um pacote de implementação de atualizações.
`newAssignmentAction`	- Gerido: `Integer` - VBScript: `Integer`	A nova ação de atribuição.
`newAssignmentDescription`	- Gerido: `String` - VBScript: `String`	A nova descrição da atribuição.
`newAssignmentName`	- Gerido: `String` - VBScript: `String`	O novo nome da atribuição.
`newDesiredConfigType`	- Gerido: `Integer` - VBScript: `Integer`	O novo tipo de configuração desejado.
`newDPLocality`	- Gerido: `Integer` - VBScript: `Integer`	A nova localidade do ponto de distribuição.
`newLocaleID`	- Gerido: `Integer` - VBScript: `Integer`	A nova identificação local.
`newLogComplianceToWinEvent`	- Gerido: `Boolean` - VBScript: `Boolean`	Determina se a conformidade está registada no registo Windows Evento. - Verdade - Falso
`newNotifyUser`	- Gerido: `Boolean` - VBScript: `Boolean`	Identifica se os utilizadores são notificados. - Verdade - Falso
`newRaiseMomAlertsOnFailure`	- Gerido: `Boolean` - VBScript: `Boolean`	Identifica se os alertas da MOM são levantados sobre o fracasso. - Verdade - Falso
`newSendDetailedNonComplianceStatus`	- Gerido: `Boolean` - VBScript: `Boolean`	Identifica se o estado de incumprimento detalhado é enviado. - Verdade - Falso
`newStartTime`	- Gerido: `String` - VBScript: `String`	A nova hora de início.
`newSuppressReboot`	- Gerido: `Integer` - VBScript: `Integer`	Identifica se o reboot é suprimido.
`newTargetCollectionID`	- Gerido: `String` - VBScript: `String`	As novas identificações de recolha de alvos.
`newUseGMTTimes`	- Gerido: `Boolean` - VBScript: `Boolean`	Identifica se deve utilizar o Tempo Universal Coordenado (UTC). - Verdade - Falso

A Compilar o Código

Este exemplo C# requer:

Espaços de nomes

Sistema

System.Collections.Generic

System.Text

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assemblagem

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

Programação Robusta

Para obter mais informações sobre o tratamento de erros, consulte Sobre erros do Gestor de Configuração.

Segurança do .NET Framework

Para obter mais informações sobre a segurança das aplicações do Gestor de Configuração, consulte a administração baseada em funções do Gestor de Configuração.

Ver também

About software update deployments (Acerca das implementações de atualizações de software)

SMS_UpdatesAssignment

Partilhar via