Como criar uma variável de coleção no Configuration Manager

Artigo
04/04/2023

Você cria uma variável de coleção para uma coleção Configuration Manager adicionando instâncias da Classe WMI do servidor SMS_CollectionVariable à CollectionVariables propriedade da Classe WMI do servidor SMS_CollectionSettings.

Para criar uma variável de coleção

Configure uma conexão com o Provedor de SMS. Para obter mais informações, confira Os fundamentos do Provedor de SMS.
Obtenha uma instância de SMS_CollectionSettings.
Para que cada variável seja adicionada, adicione instâncias do objeto inserido SMS_CollectionVariable à propriedade collectionVariables array.
Confirme as alterações na instância de SMS_CollectionSettings classe.

Exemplo

O método de exemplo a seguir cria uma variável de coleção e adiciona-a à coleção identificada pelo identificador fornecido. Se o SMS_CollectionSettings objeto da coleção não existir, ele será criado.

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

Sub CreateCollectionVariable( connection, name, value, mask, collectionId, precedence)  

    Dim collectionSettings  
    Dim collectionVariables  
    Dim collectionVariable  
    Dim Settings  

    ' See if the settings collection already exists. if it does not, create it.  
    Set settings = connection.ExecQuery _  
      ("Select * From SMS_CollectionSettings Where CollectionID = '" & collectionID & "'")  

    If settings.Count = 0 Then  
        Wscript.Echo "Creating collection settings object"  
        Set collectionSettings = connection.Get("SMS_CollectionSettings").SpawnInstance_  
        collectionSettings.CollectionID = collectionId  
        collectionSettings.Put_  
    End If    

    ' Get the collection settings object.  
    Set collectionSettings = connection.Get("SMS_CollectionSettings.CollectionID='" & collectionId &"'" )  

    ' Get the collection variables.  
    collectionVariables=collectionSettings.CollectionVariables  

    ' Create and populate a new collection variable.  
    Set collectionVariable = connection.Get("SMS_CollectionVariable").SpawnInstance_  
    collectionVariable.Name = name  
    collectionVariable.Value = value  
    collectionVariable.IsMasked = mask  

    ' Add the new collection variable.  
    ReDim Preserve collectionVariables (UBound (collectionVariables)+1)  
    Set collectionVariables(UBound(collectionVariables)) = collectionVariable  

    collectionSettings.CollectionVariables=collectionVariables  

    collectionSettings.Put_  

 End Sub

public void CreateCollectionVariable(  
    WqlConnectionManager connection,   
    string name,   
    string value,   
    bool mask,   
    string collectionId,   
    int precedence)  
{  
    try  
    {  
        IResultObject collectionSettings = null;  

        // Get the collection settings. Create it if necessary.  

         IResultObject collectionSettingsQuery = connection.QueryProcessor.ExecuteQuery(  
                    "Select * from SMS_CollectionSettings where CollectionID='" + collectionId + "'");  

         foreach (IResultObject setting in collectionSettingsQuery)  
         {  
             collectionSettings = setting;  
         }  

        if ( collectionSettings == null)  
         {  
             collectionSettings = connection.CreateInstance("SMS_CollectionSettings");  
             collectionSettings["CollectionID"].StringValue = collectionId;  
             collectionSettings.Put();  
             collectionSettings.Get();  
         }  

        // Create the collection variable.  
        List<IResultObject> collectionVariables = collectionSettings.GetArrayItems("CollectionVariables");  
        IResultObject collectionVariable = connection.CreateEmbeddedObjectInstance("SMS_CollectionVariable");  
        collectionVariable["Name"].StringValue = name;  
        collectionVariable["Value"].StringValue = value;  
        collectionVariable["IsMasked"].BooleanValue = mask;  

        // Add the collection variable to the collection settings.  
        collectionVariables.Add(collectionVariable);  
        collectionSettings.SetArrayItems("CollectionVariables", collectionVariables);  

        // Set the collection variable precedence.  
        collectionSettings["CollectionVariablePrecedence"].IntegerValue = precedence;  

        collectionSettings.Put();  
    }  
    catch (SmsException e)  
    {  
        Console.WriteLine("Failed to create collection variable: " + e.Message);  
        throw;  
   }  
}

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

Parâmetro	Tipo	Descrição
`Connection`	-Gerenciado: `WqlConnectionManager` - VBScript: SWbemServices	Uma conexão válida com o provedor de SMS.
`Name`	-Gerenciado: `String` -Vbscript: `String`	O nome da variável a ser criada.
`Value`	-Gerenciado: `String` -Vbscript: `String`	O valor da variável
`Mask`	-Gerenciado: `Boolean` -Vbscript: `Boolean`	Especifica se o valor é exibido no console Configuration Manager. `true` – o valor da variável não é exibido. `false` – o valor da variável é exibido.
`CollectionID`	-Gerenciado: `String` -Vbscript: `String`	A coleção à qual a variável é adicionada.
`Precedence`	-Gerenciado: `Integer` -Vbscript: `Integer`	A precedência da variável em relação a outras variáveis na matriz.

Compilando o código

O exemplo C# tem os seguintes requisitos de compilação:

Namespaces

System

System.Collections.Generic

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

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

Visão geral de objetos Como se conectar a um provedor de SMS no Configuration Manager usando código gerenciado
Como se conectar a um provedor de SMS no Configuration Manager usando o WMI
Como criar uma variável de computador no Configuration Manager
Como criar um objeto Configuration Manager usando código gerenciado
Como criar um objeto Configuration Manager usando o WMI
Sobre o gerenciamento de computador de implantação do sistema operacional

Compartilhar via