Classe WMI do SMS_Program Server

A SMS_Program classe WMI (Instrumentação de Gerenciamento do Windows) é uma classe de servidor de Provedor SMS, no Configuration Manager, que representa um programa ou comando a ser executado quando o software é distribuído para um computador cliente.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas.

Sintaxe

Class SMS_Program : SMS_BaseClass
{
     UInt32 ActionInProgress;
     String ApplicationHierarchy;
     String CommandLine;
     String Comment;
     String DependentProgram;
     String Description;
     UInt32 DeviceFlags;
     String DiskSpaceReq;
     String DriveLetter;
     UInt32 Duration;
     UInt8 ExtendedData[];
     UInt32 ExtendedDataSize;
     UInt8 Icon[];
     UInt32 IconSize;
     UInt8 ISVData[];
     UInt32 ISVDataSize;
     String ISVString;
     String MSIFilePath
     String MSIProductID
     String PackageID;
     String PackageName
     UInt32 PackageType
     String PackageVersion
     UInt32 ProgramFlags;
     String ProgramName;
     String RemovalKey;
     String Requirements;
     UInt32 SecuredTypeID
     SMS_OS_Details SupportedOperatingSystems[];
     UInt32   TransformReadiness=0;
     Datetime TransformAnalysisDate;
     String   TransformDtID;
     String WorkingDirectory;
};

Métodos

A SMS_Program classe não define nenhum método.

Propriedades

ActionInProgress Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [read, enumeration]

Ação atual sendo executada no pacote associado ao programa pelo Configuration Manager. Os valores possíveis são:

Use essa propriedade em uma cláusula WHERE para filtrar programas que foram marcados para exclusão, mas ainda não foram excluídos. Para obter mais informações, consulte a seção Comentários mais adiante neste tópico.

ApplicationHierarchy Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

A hierarquia de aplicativos do programa. O valor padrão é "".

CommandLine Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

A linha de comando que é executada quando o programa é iniciado. O valor padrão é "".

Comment Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

Comentário que descreve o programa no console do Configuration Manager. O valor padrão é "".

DependentProgram Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

Uma cadeia de caracteres de texto formatada que define qualquer programa que deve ser executado antes de executar esse programa. O formato é definido como <PackageID>;;<ProgramName>. Se o programa estiver no mesmo pacote, o aplicativo de chamada pode simplesmente especificar ;;<ProgramName>. O valor padrão é "".

A dependência é mantida apenas pela primeira vez que o programa é executado. Após a execução do programa, a dependência é ignorada. Por exemplo, você não pode criar um trabalho agendado recorrente para o qual a dependência é mantida para cada execução do programa.

Description Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

Não usado.

DeviceFlags Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

Sinalizadores que descrevem o dispositivo associado ao programa. Os valores possíveis são:

DiskSpaceReq Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

Espaço em disco aproximado que o programa requer. O formato é "<tamanho><KB|MB|GB".> O valor padrão é "".

Essas informações são usadas no console do Configuration Manager e no anúncio para fornecer alertas sobre os requisitos de espaço em disco do programa. O usuário pode então decidir aceitar o anúncio ou executar alguma tarefa de gerenciamento de disco primeiro.

DriveLetter Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Qualificadores: [SizeLimit("1"), Range("a-z")]

Letra da unidade (um caractere no intervalo de a-z) para a qual o programa é mapeado e executado. O valor padrão é "".

Duration Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

A duração aproximada, em minutos, da execução do programa no computador cliente. Especifique esse valor como um número inteiro maior ou igual a 0 (padrão) ou como Desconhecido (não recomendado). Se a propriedade for definida como Desconhecida, o Configuration Manager definirá o tempo de execução máximo permitido como 720 minutos (12 horas). Para obter mais informações, consulte a seção Comentários mais adiante neste tópico.

ExtendedData Tipo de dados: UInt8 matriz

Tipo de acesso: Leitura/Gravação

Eliminatórias: [grande, preguiçoso]

O blob XML para implantação de imagem.

ExtendedDataSize Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

O tamanho de dados estendido, em bytes. O valor padrão é 0.

Icon Tipo de dados: UInt8 matriz

Tipo de acesso: Leitura/Gravação

Eliminatórias: [grande]

Informações do ícone associadas ao ícone do programa, conforme exibido no console do Configuration Manager.

IconSize Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

Tamanho, em bytes, do ícone do programa. Defina essa propriedade como 0 para limpar o ícone.

ISVData Tipo de dados: UInt8 matriz

Tipo de acesso: Leitura/Gravação

Eliminatórias: [grande, preguiçoso]

Informações que permitem que um único ISV armazene dados relacionados a um SMS_Program objeto.

Não há restrições ou formatos definidos para os dados ISV. No entanto, é importante não substituir a propriedade depois que a propriedade do ISV for estabelecida. Seu aplicativo deve ler os dados existentes nessa propriedade primeiro. Se os dados não pertencerem ao aplicativo, eles não devem ser modificados. Você deve incluir um identificador nos dados do programa para que a propriedade possa ser estabelecida facilmente.

ISVDataSize Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

O tamanho, em bytes, dos dados armazenados no ISVDataformato . O valor padrão é 0.

ISVString Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Eliminatórias: nenhuma

Cadeia de caracteres para extensibilidade do parceiro.

MSIFilePath Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

O caminho do arquivo do pacote do Windows Installer ao qual o programa está associado. O valor padrão é "".

MSIProductID Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

A ID de produto do pacote do Windows Installer ao qual o programa está associado. O valor padrão é "".

PackageID Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: [chave, Not_null]

ID de um pacote existente ao qual associar o programa. Para obter mais informações, consulte a seção Comentários mais adiante neste tópico.

PackageName Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Eliminatórias: [Nenhum]

O nome do pacote ao qual o programa pertence.

PackageType Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Eliminatórias: [Nenhum]

O tipo de pacote ao qual o programa pertence.

PackageVersion Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Eliminatórias: [Nenhum]

A versão do pacote ao qual o programa pertence.

ProgramFlags Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Classificatórias: [bits]

Sinalizadores que identificam as características de instalação do programa. Os valores possíveis estão listados abaixo. Os valores padrão são EVERYUSER, USEUNCPATH, USERCONTEXT e UNATTENDED.

Os valores possíveis são:

ProgramName Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: [chave, Not_null]

Nome exclusivo que representa este programa.

RemovalKey Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

Chave do Registro que identifica o script de desinstalação do programa. O script deve residir no caminho do HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall Registro. O valor padrão é "".

Requirements Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

Descrição de quaisquer requisitos extras do programa. O valor padrão é "".

SecuredTypeID Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Eliminatórias: [Nenhum]

Tipo seguro de pacote relacionado.

SupportedOperatingSystems Tipo de dados: SMS_OS_Details matriz

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

Objetos da Classe WMI do SMS_OS_Details Server que representam os sistemas operacionais nos quais o programa pode ser executado.

Se você não especificar ANY_PLATFORM na ProgramFlags propriedade, deverá especificar um ou mais sistemas operacionais compatíveis. SMS_SupportedPlatforms Classe WMI do Server define a lista de plataformas compatíveis com o Configuration Manager.

TransformAnalysisDate Tipo de dados: DateTime

Tipo de acesso: Leitura/Gravação

Eliminatórias: [Nenhum]

Apenas para uso interno.

TransformDtID Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Eliminatórias: [Nenhum]

Apenas para uso interno.

TransformReadiness Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Eliminatórias: [Nenhum]

Apenas para uso interno.

WorkingDirectory Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

O local a partir do qual o programa é executado. O valor padrão é "".

O diretório de trabalho pode ser um caminho absoluto no cliente ou um caminho relativo à pasta do ponto de distribuição que contém o pacote. Se um diretório de trabalho não for especificado, o Configuration Manager usará a pasta de ponto de distribuição padrão.

Comentários

Não há qualificadores de classe especial para esta classe. Para obter mais informações sobre os qualificadores de classe e os qualificadores de propriedade incluídos na seção Propriedades, consulte Qualificadores de classe e propriedade do Configuration Manager.

Um programa está sempre associado a um pacote pai e normalmente representa o programa de instalação do pacote. Mais de um programa pode ser associado ao mesmo pacote. O aplicativo usa a PackageID propriedade para fazer essa associação. Seu aplicativo não pode alterar essa propriedade depois que o SMS_Program objeto é criado. Para associar o programa a um pacote diferente, o aplicativo deve excluir o objeto e criar um novo objeto com um novo PackageID valor.

Quando seu aplicativo exclui um SMS_Program objeto, ele não é excluído até que seus componentes relacionados, como seus anúncios, sejam excluídos. Em vez disso, o Configuration Manager define a ActionInProgress propriedade como DELETE (3) para marcar o programa para exclusão. Para garantir que uma consulta não recupere programas que foram marcados para exclusão, adicione esse caso à cláusula WHERE.

É recomendável que você não defina a Duration propriedade como Unknown porque essa propriedade é usada para as duas finalidades importantes a seguir:

• Monitorar os resultados do programa.

• Para determinar se o programa será iniciado quando as janelas de manutenção tiverem sido definidas nos computadores cliente.

  Se o aplicativo definir a propriedade, mas o Duration tempo de execução do programa exceder essa duração, o Configuration Manager interromperá o monitoramento do programa, mas não encerrará o programa. Isso permite que o Configuration Manager continue com outras funções de distribuição de software, como executar outros programas anunciados. O gerente não:

• Interrompa o programa.

• Libere todas as unidades que foram mapeadas para o programa anunciado.

• Libere todas as conexões de rede feitas para o programa anunciado.

• Recursos gratuitos do sistema operacional usados pelo Configuration Manager quando os programas anunciados estão em execução.

  Para obter mais informações, consulte Sobre janelas de manutenção.

Requisitos

Requisitos de tempo de execução

Para obter mais informações, consulte Requisitos de tempo de execução do servidor do Configuration Manager.

Requisitos de desenvolvimento

Para obter mais informações, consulte Requisitos de Desenvolvimento de Servidor do Configuration Manager.

Confira também

Classe WMI do SMS_Package ServerComo criar um pacoteComo criar um programa