Como Criar um Programa

Artigo
08/13/2021

O exemplo a seguir mostra como criar um programa, no Gestor de Configuração, utilizando as propriedades de SMS_Program classe e classe.

Importante

Qualquer programa anunciado não será executado quando as janelas de manutenção definidas no computador cliente estiverem definidas por um período inferior à definição máxima permitida pelo programa. Para obter mais informações, consulte o cenário de execução do programa utilizando Windows de manutenção na documentação do Gestor de Configuração.

Para criar um programa

Configurar uma ligação com o Fornecedor DE SMS.
Crie o novo objeto do programa utilizando a SMS_Program classe.

Povoar as novas propriedades do programa.

Dica

Quando criar um programa para uma Sequência de Tarefas ou um Pacote de Aplicações Virtuais, as propriedades SMS_Program devem ser definidas para valores específicos. As tabelas a seguir em dia descrevem a que definições devem ser configuradas.

Sequência de tarefas

Nome da Propriedade	Valor de Propriedade
ProgramName	*

Pacote de Aplicação Virtual

Nome da Propriedade	Valor de Propriedade
Linha de Comando	PkgGUID={E742FFD6-D539-42CC-9827-73535FC81E06}:VersionGUId={19366289-8C55-44E2-A5EC-7B385EFB4C30} Nota: Os valores GUID são retirados do ficheiro manifesto XML da aplicação virtual.
ProgramName	[Aplicação virtual]

Guarde o novo programa e propriedades.

Exemplo

O método exemplo a seguir cria um novo programa e povoa as suas propriedades para utilização na distribuição de software.

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


Sub CreateProgram(connection, existingPackageID, newProgramName, newProgramComment, newProgramCommandLine, newMaxRunTime)  

    ' Create the new program object.    Dim newProgram  
    Set newProgram = connection.Get("SMS_Program").SpawnInstance_  

    ' Populate the program properties.  
    newProgram.PackageID = existingPackageID  
    newProgram.ProgramName = newProgramName  
    newProgram.Comment = newProgramComment  
    newProgram.CommandLine = newProgramCommandLine  
    newProgram.Duration = newMaxRunTime  

    ' Save the new program and properties.  
    newProgram.Put_  

    ' Output new program name.  
    wscript.echo "Created program: " & newProgramName  

End Sub

public void CreateProgram(WqlConnectionManager connection,   
                          string existingPackageID,   
                          string newProgramName,   
                          string newProgramComment,   
                          string newProgramCommandLine,  
                          int newMaxRunTime)  
{  
    try  
    {  
        // Create an instance of SMS_Program.  
        IResultObject newProgram = connection.CreateInstance("SMS_Program");  

        // Populate basic program values.  
        newProgram["PackageID"].StringValue = existingPackageID;  
        newProgram["ProgramName"].StringValue = newProgramName;  
        newProgram["Comment"].StringValue = newProgramComment;  
        newProgram["CommandLine"].StringValue = newProgramCommandLine;  
        newProgram["Duration"].IntegerValue = newMaxRunTime;  

        // Save the new program instance and values.  
        newProgram.Put();  

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

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

Parâmetro	Tipo	Description
`connection` `swebemServices`	- Gerido: `WqlConnectionManager` - VBScript: SWbemServices	Uma ligação válida ao Fornecedor de SMS.
`existingPackageID`	- Gerido: `String` - VBScript: `String`	O nome do pacote associado ao programa.
`newProgramName`	- Gerido: `String` - VBScript: `String`	O nome do novo programa.
`newProgramComment`	- Gerido: `String` - VBScript: `String`	Comentário que descreve o programa na consola Do Gestor de Configuração.
`newProgramCommandLine`	- Gerido: `String` - VBScript: `String`	A linha de comando que funciona quando o programa é lançado.
`newMaxRunTime`	- Gerido: `Integer` - VBScript: `Integer`	A duração aproximada, em minutos, da execução do programa no computador cliente. Este parâmetro pode ter um valor máximo de 720 minutos ou 12 horas.

A Compilar o Código

O exemplo C# requer:

Espaços de nomes

Sistema

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assemblagem

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

mscorlib

Programação Robusta

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

Consulte também

Software distribution overview (Descrição geral da distribuição de software)

Partilhar via