Como modificar propriedades do programa

Artigo
04/04/2023

O exemplo a seguir mostra como modificar um programa, em Configuration Manager, usando as classes e SMS_Program as SMS_Package propriedades.

Para modificar as propriedades do programa

Configure uma conexão com o Provedor de SMS.
Obtenha a instância do programa usando a ID do pacote e o nome do programa fornecidos.
Substitua a propriedade de descrição do programa pela passada para o método.
Salve o objeto e as propriedades do programa.

Exemplo

O método de exemplo a seguir modifica as propriedades do programa para distribuição de software.

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


Sub ModifyProgram(connection, existingpackageID, existingProgramNameToModify, newProgramDescription)    

     ' Load the specific program to change (programname is a key value and must be unique).     Dim program  
     Set program = connection.Get("SMS_Program.PackageID='" & existingPackageID & "'" & ",ProgramName='" & existingProgramNameToModify & "'")  

     ' Replace the existing program property (in this case the program description).  
     program.Description = newProgramDescription  
     program.Comment = newProgramDescription  
     ' Save the program with the modified properties.  
     program.Put_  

     ' Output program name.  
     WScript.echo "Modified program: " & program.ProgramName              

End Sub


public void ModifyProgram(WqlConnectionManager connection, string existingPackageID, string existingProgramNameToModify, string newProgramDescription)  
{  

    try  
    {  

        // Load the specific program to change (programname is a key value and must be unique).  
        IResultObject program = connection.GetInstance(@"SMS_Program.PackageID='" + existingPackageID + "',ProgramName='" + existingProgramNameToModify + "'");  

        // Replace the existing program property (in this case the program description).  
        program["Description"].StringValue = newProgramDescription;  
        program["Comment"].StringValue = newProgramDescription;  
        // Save the program with the modified properties.  
        program.Put();  

        // Output program name.  
        Console.WriteLine("Modified program: " + program["ProgramName"].StringValue);  

    }  
    catch (SmsException ex)  
    {  
        Console.WriteLine("Failed to modify the program. Error: " + ex.Message);  
        throw;  
    }  
}

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

Parâmetro	Tipo	Descrição
`connection` `swbemServices`	-Gerenciado: `WqlConnectionManager` - VBScript: SWbemServices	Uma conexão válida com o provedor de SMS.
`existingPackageID`	-Gerenciado: `String` -Vbscript: `String`	A ID de um pacote existente com o qual associar o programa.
`existingProgramNameToModify`	-Gerenciado: `String` -Vbscript: `String`	O nome do programa a ser modificado.
`newProgramDescription`	-Gerenciado: `String` -Vbscript: `String`	A descrição do novo programa.

Compilando o código

O exemplo C# requer:

Namespaces

Sistema

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

Mscorlib

Programação robusta

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

Confira também

Visão geral da distribuição de software

Compartilhar via