Classe WMI do servidor SMS_StatusMessage
A SMS_StatusMessage
classe WMI (Instrumentação de Gerenciamento do Windows) é uma classe de servidor provedor de SMS, em Configuration Manager, que representa mensagens de status individuais geradas por Configuration Manager para fornecer informações sobre uma variedade de eventos, incluindo conclusão do processo, erros, condições e ações do usuário.
A sintaxe a seguir é simplificada do código MOF (Formato de Objeto Gerenciado) e inclui todas as propriedades herdadas.
Sintaxe
Class SMS_StatusMessage : SMS_BaseClass
{
String Component;
String MachineName;
UInt32 MessageID;
UInt32 MessageType;
String ModuleName;
UInt32 PerClient;
UInt32 ProcessID;
SInt64 RecordID;
UInt32 ReportFunction;
UInt32 Severity;
String SiteCode;
UInt32 SuccessfulTransaction;
UInt32 ThreadID;
DateTime Time;
String TopLevelSiteCode;
UInt32 Transaction;
UInt32 Win32Error;
};
Métodos
A tabela a seguir lista os métodos em SMS_StatusMessage
.
Método | Descrição |
---|---|
Método DeleteByID na classe SMS_StatusMessage | Exclui um grupo de até 256 mensagens de status. |
Método DeleteByQuery na classe SMS_StatusMessage | Exclui um grupo de mensagens de status especificadas por uma instrução SELECT do idioma de consulta WMI. |
Método RaiseErrorStatusMsg na classe SMS_StatusMessage | Cria uma mensagem de status de erro. |
Método RaiseInformationalStatusMsg na classe SMS_StatusMessage | Cria uma mensagem de status informativo. |
Método RaiseRawStatusMsg na classe SMS_StatusMessage | Cria uma mensagem de status de uma DLL de mensagem externa. |
Método RaiseWarningStatusMsg na classe SMS_StatusMessage | Cria uma mensagem de status de aviso. |
Propriedades
Component
Tipo de dados: String
Tipo de acesso: Leitura
Qualificadores: Nenhum
Nome do componente que criou a mensagem. Para mensagens definidas pelo usuário, esse nome vem do ApplicationName
qualificador de contexto que você deve definir antes de chamar um método de mensagem de status de aumento.
MachineName
Tipo de dados: String
Tipo de acesso: Leitura
Qualificadores: Nenhum
Nome do computador que criou a mensagem. Para mensagens definidas pelo usuário, esse nome vem do MachineName
qualificador de contexto que você deve definir antes de chamar um método de mensagem de status de aumento.
MessageID
Tipo de dados: UInt32
Tipo de acesso: Leitura
Qualificadores: [Range("0-65535")]
ID exclusiva do texto da mensagem em uma DLL de mensagem. Essa propriedade é definida como o valor associado quando seu aplicativo chama um método listado na tabela a seguir.
MessageType
Tipo de dados: UInt32
Tipo de acesso: Leitura
Qualificadores: Nenhum
Tipo de mensagem. Os valores possíveis são:
Valor | Tipo de mensagem |
---|---|
256 | Marco. Use esse tipo no final de uma operação para indicar o sucesso ou falha da operação. Se a operação tiver sido bem-sucedida, use o tipo Milestone em uma mensagem informativa. Se a operação falhar, use um tipo de mensagem de marco em uma mensagem de aviso ou erro. |
512 | Detalhe. Use esse tipo para ilustrar as etapas em uma operação complexa. Geralmente, as mensagens de detalhes são significativas apenas no contexto da sequência de mensagens de status que representam uma operação complexa. |
768 | Auditoria. Use esse tipo para mensagens informativas que fornecem um rastro de ações tomadas pelo administrador do Configuration Manager. Uma mensagem de auditoria também mostra uma operação que resulta em objetos sendo adicionados, modificados ou excluídos. Você não precisa criar mensagens de auditoria; o provedor gera automaticamente essas mensagens para você. |
1024 | NTEvent. |
ModuleName
Tipo de dados: String
Tipo de acesso: Leitura
Qualificadores: Nenhum
A DLL associada à mensagem de status. Esse não é o nome da DLL em si, mas uma cadeia de caracteres de exibição correspondente ao valor da ModuleName
propriedade definido na classe WMI do servidor SMS_StatMsgModuleNames . Você usa o ModuleName
valor para obter o nome DLL.
PerClient
Tipo de dados: UInt32
Tipo de acesso: Leitura
Qualificadores: Nenhum
Valor que indica se a mensagem de status foi gerada por um componente cliente. Os valores possíveis estão listados abaixo. As mensagens geradas por cliente tendem a ser bastante numerosas. Assim, essa propriedade fornece uma maneira fácil de filtre-los.
Valor | Mensagem gerada por cliente |
---|---|
0 | false |
2 | true |
ProcessID
Tipo de dados: UInt32
Tipo de acesso: Leitura
Qualificadores: Nenhum
ID do processo que criou a mensagem.
RecordID
Tipo de dados: SInt64
Tipo de acesso: Leitura
Qualificadores: [chave]
ID exclusiva da mensagem de status.
ReportFunction
Tipo de dados: UInt32
Tipo de acesso: Leitura
Qualificadores: Nenhum
Função de relatório. Os valores possíveis são:
Valor | Função de relatório |
---|---|
0 | Relatório |
16 | Begintransaction |
32 | CommitSuccessfulTransaction |
48 | CommitFailedTransaction |
64 | Rollbacktransaction |
80 | ReportEX |
Severity
Tipo de dados: UInt32
Tipo de acesso: Leitura
Qualificadores: Nenhum
Gravidade da mensagem de status. Os valores possíveis são:
Valor | Severity |
---|---|
0x40000000 (1073741824) | Informativo |
0x80000000 (2147483648) | Aviso |
0xC0000000 (3221225472) |
Error |
SiteCode
Tipo de dados: String
Tipo de acesso: Leitura
Qualificadores: [SizeLimit("3")]
Código do site do site que criou a mensagem.
SuccessfulTransaction
Tipo de dados: UInt32
Tipo de acesso: Leitura
Qualificadores: Nenhum
Valor que indica o status da transação. Os valores possíveis são:
Valor | Status da transação |
---|---|
0 | Falhou |
8 | Com êxito |
ThreadID
Tipo de dados: UInt32
Tipo de acesso: Leitura
Qualificadores: Nenhum
Identificador do thread que criou a mensagem.
Time
Tipo de dados: DateTime
Tipo de acesso: Leitura
Qualificadores: Nenhum
Data e hora, em TEMPO Coordenado Universal (UTC), quando a mensagem de status foi criada.
TopLevelSiteCode
Tipo de dados: String
Tipo de acesso: Leitura
Qualificadores: [SizeLimit("3")]
Essa propriedade está preterida.
Transaction
Tipo de dados: UInt32
Tipo de acesso: Leitura
Qualificadores: Nenhum
Valor que indica se as transações estão habilitadas. Os valores possíveis são:
Valor | Transação habilitada |
---|---|
0 | Falso |
4 | Verdadeiro |
Win32Error
Tipo de dados: UInt32
Tipo de acesso: Leitura
Qualificadores: Nenhum
Código de erro Win32 associado à mensagem de status.
Comentários
As qualificatórias de classe para esta classe incluem:
Leitura (somente leitura)
Protegido
Para obter mais informações sobre as qualificatórias de classe e as qualificatórias de propriedade incluídas na seção Propriedades, consulte Configuration Manager Qualificadores de Classe e Propriedade.
Você pode essa classe para gerar mensagens de status definidas pelo usuário.
Observação
Use a classe WMI do servidor SMS_StatMsg para uma versão de alto desempenho desta classe.
Requisitos
Requisitos de runtime
Para obter mais informações, consulte Configuration Manager Requisitos de Runtime do Servidor.
Requisitos de desenvolvimento
Para obter mais informações, consulte Configuration Manager Requisitos de Desenvolvimento do Servidor.