Compartilhar via


Como modificar propriedades do programa

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

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

  2. Obtenha a instância do programa usando a ID do pacote e o nome do programa fornecidos.

  3. Substitua a propriedade de descrição do programa pela passada para o método.

  4. 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