Como ler uma lista de propriedades integradas de arquivo de controle de site Configuration Manager

Artigo
04/04/2023

Em Configuration Manager, você lê uma lista de propriedades inseridas de um recurso de arquivo de controle de site obtendo o objeto SMS_EmbeddedPropertyList do objeto inserido da matriz de propriedades PropLists de recursos.

Uma lista de propriedades inseridas tem as seguintes propriedades que você pode definir. Para obter mais informações, consulte SMS_EmbeddedPropertyList.

Valor	Descrição
PropertyListName	O nome da propriedade inserida.
Valores	Uma matriz de valores de cadeia de caracteres. Cada item de matriz representa um único item de lista de propriedades.

Cuidado

Fazer alterações no arquivo de controle do site pode causar danos irreparáveis ao seu site Configuration Manager.

Para ler uma lista de propriedades inseridas de arquivo de controle de site

Configure uma conexão com o Provedor de SMS. Para obter mais informações, confira Os fundamentos do Provedor de SMS.
Usando o objeto de conexão da primeira etapa, obtenha um recurso de arquivo de controle de site. Para obter mais informações, consulte Sobre o arquivo de controle de site Configuration Manager.
Obtenha o SMS_EmbeddedPropertyList para a lista de propriedades inseridas necessária.
Acesse os valores da lista de propriedades usando a matriz de propriedades Values do SMS_EmbeddedPropertyList objeto.

Exemplo

O método de exemplo a seguir preenche o parâmetro fornecido values com a matriz Values da lista SMS_EmbeddedPropertyList de propriedades inseridas identificada pelo propertyListName parâmetro. true será retornada se a lista de propriedades inseridas for encontrada; caso contrário, false é retornado.

Para exibir o código que chama essas funções, consulte Como ler e gravar no arquivo de controle de site Configuration Manager usando código gerenciado ou ver Como ler e gravar no arquivo de controle de site Configuration Manager usando o WMI.

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


Function GetScfEmbeddedPropertyList(resource,  _  
        propertyListName,               _  
        ByRef values)  

    Dim scfPropertyList  

    If IsNull(resource.PropLists) = True Then  
        GetScfPropertyList = False  
        Exit Function  
    End If      

    For each scfPropertyList in resource.PropLists  
       if   scfPropertyList.PropertyListName = propertyListName Then  
            ' Found property list, so return the values array.  
            values = scfPropertyList.Values  
            GetScfEmbeddedPropertyList = True  
            Exit Function  
        End If  
     Next    

     ' Did not find the property list.  
     GetScfEmbeddedPropertyList = False  
End Function

public bool GetScfEmbeddedPropertyList(  
    IResultObject resource,  
    string propertyListName,  
    out ArrayList values)  
{  
    values = new ArrayList();  
    try  
    {  
        if (resource.EmbeddedPropertyLists.ContainsKey(propertyListName))  
        {  
            values.AddRange(resource.EmbeddedPropertyLists[propertyListName]["Values"].StringArrayValue);  
            return true;  
        }  
    }  
    catch(SmsException e)  
    {  
        Console.WriteLine("Couldn't get the embedded property list: " + e.Message);  
    }  
    return false;  

}

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

Parâmetro	Tipo	Descrição
`Resource`	-Gerenciado: `IResultObject` - VBScript: SWbemObject	O recurso de arquivo de controle de site que contém a propriedade inserida.
`propertyListName`	-Gerenciado: `String` -Vbscript: `String`	A lista de propriedades inseridas a ser lida.
`Values`	– Gerenciado: `String` matriz - VBScript: `String` matriz	A `SMS_EmbeddedProperty` propriedade Valores de classe. Uma matriz de valores de cadeia de caracteres.

Compilando o código

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

Namespaces

System

System.Collections.Generic

System.Collections

System.Text

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

Sobre o arquivo de controle de site Configuration Manager
Como ler e gravar no arquivo de controle de site Configuration Manager usando código gerenciado
Como ler e gravar no arquivo de controle de site Configuration Manager usando o WMI

Compartilhar via