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

Artigo
04/04/2023

Você remove as atualizações de um pacote de implantação de atualizações de software, em 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

Configure uma conexão com o Provedor de SMS.
Obtenha um objeto de pacote existente usando a SMS_SoftwareUpdatesPackage classe.
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 de VBScript foi incluído, pois o RemoveContent método não retorna da chamada de método sobre falha. Este é um problema conhecido e está sendo investigado.

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

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 de exemplo 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 de um pacote de gerenciamento de atualizações de software existente.
`removecontentParameters`	-Gerenciado: `dictionary object`	O conjunto de parâmetros (`ContentIDs`, `bRefreshDPs`) que é passado para o método e usado com a chamada de `RemoveContent` método.

Compilando o código

Este exemplo de C# 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 Sobre erros de Configuration Manager.

Segurança do .NET Framework

Para obter mais informações sobre como proteger aplicativos Configuration Manager, consulte Configuration Manager administração baseada em função.

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 na classe SMS_SoftwareUpdatesPackage

Compartilhar via