Como adicionar um qualificador de contexto de Configuration Manager usando o WMI

Artigo
04/04/2023

Em Configuration Manager, você adiciona qualificadores de contexto a uma conexão (SWbemServices) ou objeto (SWbemObject) criando um valor SWbemNamedValueSet definido para manter as qualificações de contexto. Em seguida, você fornece o valor SWbemNamedValueSet definido como um parâmetro para métodos de conexão e objeto.

em Configuration Manager, você pode fornecer o nome do aplicativo (ApplicationName), o nome do computador (MachineName) e o identificador de localidade (LocaleID).

Na maioria dos casos, qualificadores de contexto não são necessários. A principal exceção é acessar o arquivo de controle do site em que eles são necessários para configurar informações de sessão. Para obter mais informações, consulte Sobre o arquivo de controle de site Configuration Manager.

Para adicionar um qualificador de contexto Configuration Manager

Configure uma conexão com o Provedor de SMS. Para obter mais informações, confira Os fundamentos do Provedor de SMS.
Crie um objeto WbemScripting.SWbemNamedValueSet e adicione os qualificadores de contexto desejados.
Use o conjunto de valores SWbemNamedValue que você criou na etapa dois para passar qualificadores de contexto para chamadas de conexão e manipulação de objeto.

Exemplo

O exemplo VBScript a seguir cria um conjunto de valores SWbemNamedValueSet e adiciona as qualificações de contexto fornecidas. O exemplo de código a seguir demonstra como chamar o método para uso em uma chamada de método Put de objeto de pacote SMS_Package. Para obter mais informações sobre Configuration Manager objetos, consulte Visão geral de objetos.

Dim context

Set context = CreateContextQualifiers("My application" , "My Computer" , "MS\1033")

package.Put_ , context

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


Function CreateContextQualifiers(applicationName, machineName, localeID)  
    On Error Resume next  
    Dim smsContext  

    set smsContext = CreateObject("WbemScripting.SWbemNamedValueSet")  

    ' Add the context qualifiers to the set.  
    smsContext.Add "LocaleID", localeID  
    smsContext.Add "MachineName", machineName  
    smsContext.Add "ApplicationName", applicationName  

    Set CreateContextQualifiers = smsContext  

      If Err.Number<>0 Then  
        WScript.Echo Err.Description  
        CreateContextQualifiers = null  
        Exit Function  
    End If  
End Function

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

Parâmetro	Tipo	Descrição
`applicationName`	- `String`	O qualificador de contexto ApplicationName.
`machineName`	- `String`	O qualificador de nome do computador.
`localeID`	- `String`	O identificador de localidade. Por exemplo, MS\1033 é inglês (EUA). Se você precisar da localidade para não-EUA. instalações, você pode obtê-lo na propriedade classe `LocaleID`WMI do servidor SMS_Identification.

Compilando o código

Este exemplo do VBScript requer:

Programação robusta

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

Segurança do .NET Framework

Para obter mais informações sobre como proteger aplicativos Configuration Manager, consulte Configuration Manager administração baseada em função.

Confira também

Sobre o arquivo de controle de site Configuration Manager
Visão geral dos objetos Configuration Manager Qualificadores de Contexto
Como se conectar a um provedor de SMS no Configuration Manager usando o WMI
Instrumentação de gerenciamento do Windows