Como excluir atualizações de um pacote de implantação

Você remove atualizações de um pacote de implantação de atualizações de software, no Configuration Manager, obtendo uma instância da classe SMS_SoftwareUpdatesPackage e usando o método RemoveContent.

Para excluir atualizações de um pacote de implantação de atualizações de software

  1. Configurar uma conexão com o Provedor de SMS.

  2. Obtenha um objeto de pacote existente usando a SMS_SoftwareUpdatesPackage classe.

  3. Remova o conteúdo de atualização do pacote de gerenciamento de atualizações de software existente usando o RemoveContent método.

Exemplo

O método de exemplo a seguir mostra como remover atualizações de um pacote de implantação de atualizações de software usando a SMS_SoftwareUpdatesPackage classe e o RemoveContent método.

Importante

Nenhum exemplo do VBScript foi incluído, pois o RemoveContent método não retorna da chamada de método sobre falha. Esse é um problema conhecido e está sendo investigado.

Para obter informações sobre como chamar o código de exemplo, consulte Calling Configuration Manager Code Snippets.

Exemplo da chamada de método em C#:


// Prework for RemoveUpdatesfromSUMDeploymentPackage.  
// Define the array of Content IDs to load into the content parameters.  
int[] newArrayContentIDs2 = new int[] { 82 };  

// Load the update content parameters into an object to pass to the method.  
Dictionary<string, object> removeContentParameters = new Dictionary<string, object>();  
removeContentParameters.Add("ContentIDs", newArrayContentIDs2);  
removeContentParameters.Add("bRefreshDPs", true);  

// Call the RemoveUpdatesfromSUMDeploymentPackage method.  
RemoveUpdatesfromSUMDeploymentPackage(WMIConnection,  
                                      "ABC00001",  
                                      removeContentParameters);  


public void RemoveUpdatesfromSUMDeploymentPackage(WqlConnectionManager connection,  
                                                  string existingSUMPackageID,  
                                                  Dictionary<string, object> removeContentParameters)  
{  
    try  
    {  
        // Get the specific SUM Deployment Package to change.  
        IResultObject existingSUMDeploymentPackage = connection.GetInstance(@"SMS_SoftwareUpdatesPackage.PackageID='" + existingSUMPackageID + "'");  

        // Remove updates from the existing SUM Deployment Package using the RemoveContent method.  
        // Note: The method will throw an exception, if the method is not able to add the content.  
        IResultObject result = existingSUMDeploymentPackage.ExecuteMethod("RemoveContent", removeContentParameters);  

        // Output a success message.  
        Console.WriteLine("Removed content from the deployment package. ");  

    }  
    catch (SmsException ex)  
    {  
        Console.WriteLine("Failed to remove content from the deployment package. Error: " + ex.Message);  
        throw;  
    }  
}  

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

Parâmetro Tipo Descrição
connection - Gerenciado: WqlConnectionManager Uma conexão válida com o Provedor de SMS.
existingSUMPackageID - Gerenciado: String A ID do pacote para um pacote de gerenciamento de atualizações de software existente.
removecontentParameters - Gerenciado: dictionary object O conjunto de parâmetros ( , ) que ContentIDs é passado para o método e usado com a chamada de bRefreshDPs RemoveContent método.

Compilando o código

Este C# exemplo requer:

Namespaces

System

System.Collections.Generic

System.Text

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

Programação robusta

Para obter mais informações sobre o tratamento de erros, consulte About Configuration Manager Errors.

Segurança do .NET Framework

Para obter mais informações sobre como proteger aplicativos do Configuration Manager, consulte Configuration Manager role-based administration.

Confira também

Sobre implantações de atualização de software Como atribuir um pacote a um ponto de distribuição
SMS_SoftwareUpdatesPackage
Método RemoveContent em Classe SMS_SoftwareUpdatesPackage