Compartilhar via


How to Read a Configuration Manager Site Control File Embedded Property List (Como Ler uma Lista de Propriedades Incorporadas de Ficheiros de Controlo de Sites do Configuration Manager)

No Configuration Manager, leu uma lista de propriedades incorporada a partir de um recurso de ficheiro de controlo de site ao obter o objeto SMS_EmbeddedPropertyList para o objeto incorporado a partir da matriz de propriedades PropLists de recursos.

Uma lista de propriedades incorporadas tem as seguintes propriedades que pode definir. Para obter mais informações, veja SMS_EmbeddedPropertyList.

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

Cuidado

Fazer alterações ao ficheiro de controlo do site pode causar danos irreparáveis no site Configuration Manager.

Para ler uma lista de propriedades incorporadas de um ficheiro de controlo de site

  1. Configure uma ligação ao Fornecedor de SMS. Para obter mais informações, veja Noções básicas do Fornecedor de SMS.

  2. Com o objeto de ligação do passo um, obtenha um recurso de ficheiro de controlo de site. Para obter mais informações, veja Acerca do Ficheiro de Controlo de Sites do Configuration Manager.

  3. Obtenha o SMS_EmbeddedPropertyList para a lista de propriedades incorporadas necessária.

  4. Aceda aos valores da lista de propriedades com a matriz de propriedades Valores do SMS_EmbeddedPropertyList objeto.

Exemplo

O método de exemplo seguinte preenche o parâmetro fornecido values com a matriz Valores da lista SMS_EmbeddedPropertyList de propriedades incorporadas identificada pelo propertyListName parâmetro . true é devolvido se a lista de propriedades incorporadas for encontrada; caso contrário, false é devolvido.

Para ver o código que chama estas funções, consulte How to Read and Write to the Configuration Manager Site Control File by Using Managed Code (Como Ler e Escrever no Ficheiro de Controlo de Sites do Configuration Manager através da WMI).

Para obter informações sobre como chamar o código de exemplo, veja Chamar Configuration Manager Fragmentos 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 - Gerido: IResultObject
- VBScript: SWbemObject
O recurso de ficheiro de controlo do site que contém a propriedade incorporada.
propertyListName - Gerido: String
- VBScript: String
A lista de propriedades incorporadas a ler.
Values - Gerido: String matriz
- VBScript: String matriz
A SMS_EmbeddedProperty propriedade Valores da classe. Uma matriz de valores de cadeia.

Compilando o código

O exemplo de 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 processamento de erros, veja About Configuration Manager Errors (Acerca dos Erros de Configuration Manager).

Segurança do .NET Framework

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

Confira também

Acerca do Configuration Manager Ficheiro de Controlo de SitesComo Ler e Escrever no Ficheiro de Controlo de Sites do Configuration Manager utilizando o Código GeridoComo Ler e Escrever no Ficheiro de Controlo de Sites Configuration Manager utilizando a WMI