Configuration Manager webhelyvezérlő fájl beágyazott tulajdonságlistájának olvasása

A Configuration Manager beolvas egy beágyazott tulajdonságlistát egy helyvezérlőfájl-erőforrásból, és beolvassa a beágyazott objektum SMS_EmbeddedPropertyList objektumát az resources PropLists tulajdonságtömbből.

A beágyazott tulajdonságok listájában a következő tulajdonságok állíthatók be. További információ: SMS_EmbeddedPropertyList.

Érték	Leírás
PropertyListName	A beágyazott tulajdonság neve.
Értékek	Sztringértékek tömbje. Minden tömbelem egyetlen tulajdonságlista-elemet jelöl.

Figyelem

A helyvezérlő fájl módosítása helyrehozhatatlan károkat okozhat a Configuration Manager helyén.

Webhelyvezérlő fájl beágyazott tulajdonságlistájának olvasása

1. Állítson be egy kapcsolatot az SMS-szolgáltatóval. További információ: Az SMS-szolgáltató alapjai.

2. Az első lépésben található kapcsolatobjektum használatával szerezzen be egy helyvezérlőfájl-erőforrást. További információ: Tudnivalók a Configuration Manager helyvezérlő fájlról.

3. Kérje le a SMS_EmbeddedPropertyList szükséges beágyazott tulajdonságlistát.

4. A tulajdonságlista értékeit az object Values tulajdonságtömb használatával érheti SMS_EmbeddedPropertyList el.

Példa

Az alábbi példametódus feltölti a megadott paramétert values a paraméter által propertyListName azonosított beágyazott tulajdonságlista SMS_EmbeddedPropertyListValues tömbjével. true a függvény akkor adja vissza a függvényt, ha a beágyazott tulajdonságlista megtalálható; false ellenkező esetben a függvény visszaadja.

Az ezeket a függvényeket meghívó kód megtekintéséhez olvassa el a How to Read and Write to the Configuration Manager Site Control File by Using Managed Code (A Configuration Manager helyvezérlő fájlba történő olvasás és írás felügyelt kód használatával) című témakört, vagy olvassa el a How to Read and Write to the Configuration Manager Site Control File by Using WMI (A Configuration Manager helyvezérlő fájl olvasása és írása WMI használatával) című témakört.

A mintakód meghívásával kapcsolatos információkért lásd: Configuration Manager Kódrészletek hívása.

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;  

}  

A mintametódus a következő paraméterekkel rendelkezik:

Paraméter	Típus	Leírás
Resource	-Kezelt: IResultObject - VBScript: SWbemObject	A beágyazott tulajdonságot tartalmazó helyvezérlőfájl-erőforrás.
propertyListName	-Kezelt: String -Vbscript: String	A beolvasandó beágyazott tulajdonságlista.
Values	- Felügyelt: String tömb - VBScript: String tömb	A SMS_EmbeddedProperty class Values (Értékek) tulajdonság. Sztringértékek tömbje.

A kód fordítása

A C# példa a következő fordítási követelményekkel rendelkezik:

Névterek

Rendszer

System.Collections.Generic

System.Collections

System.Text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Összeszerelés

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robusztus programozás

A hibakezeléssel kapcsolatos további információkért lásd: A Configuration Manager hibák ismertetése.

.NET-keretrendszer Security

A Configuration Manager alkalmazások biztonságossá tételével kapcsolatos további információkért lásd: Configuration Manager szerepköralapú felügyelet.

Lásd még

Tudnivalók a Configuration Manager webhelyvezérlő fájlról
A Configuration Manager helyvezérlő fájl olvasása és írása felügyelt kód használatával
A Configuration Manager helyvezérlő fájl olvasása és írása WMI használatával