Odstranění kolekce

Aplikace může odstranit kolekci v Configuration Manager pomocí vlastností třídy a třídy služby WMI serveru SMS_Collection.

Důležité

• Při odstraňování jakéhokoli objektu Configuration Manager byste měli věnovat pozornost.

• Pokud odstraňujete několik kolekcí, doporučujeme, abyste to udělali jednu po druhé, abyste umožnili databázovým operacím spravovat změny spojené s odstraněním.

Kolekce jsou úzce svázány s balíčky, programy a reklamami. Další informace najdete v tématu Přehled distribuce softwaru.

Tyto příklady vyžadují následující hodnoty:

• Objekt připojení rozhraní WMI (Windows Management Instrumentation).

• ID existující kolekce.

  Následující kód je příkladem volání podprogramu v jazyce Visual Basic:

Call DeleteCollection(swbemServices,"ABC00010")  

Následující kód je příkladem volání metody v jazyce C#:

DeleteCollection(WMIConnection,"ABC00010")  

Odstranění kolekce

1. Nastavte připojení k poskytovateli serveru SMS. Další informace najdete v tématu Základy poskytovatele serveru SMS.

2. Získejte konkrétní instanci kolekce pomocí zadaného ID kolekce.

3. Odstraňte kolekci pomocí metody delete.

Příklad

Následující ukázková metoda odstraní kolekci.

Informace o volání ukázkového kódu najdete v tématu Volání Configuration Manager fragmentů kódu.

' Setup a connection to the local provider.  
Set swbemLocator = CreateObject("WbemScripting.SWbemLocator")  
Set swbemServices= swbemLocator.ConnectServer(".", "root\sms")  
Set providerLoc = swbemServices.InstancesOf("SMS_ProviderLocation")  

For Each Location In providerLoc  
    If location.ProviderForLocalSite = True Then  
        Set swbemServices = swbemLocator.ConnectServer(Location.Machine, "root\sms\site_" + Location.SiteCode)  
        Exit For  
    End If  
Next  

Call DeleteCollection(swbemServices,"ABC00010")  

Sub DeleteCollection(connection, collectionIDToDelete)  

    ' Get the specific collection instance to delete.  
    Set collectionToDelete = connection.Get("SMS_Collection.CollectionID='" & collectionIDToDelete & "'")  

    ' Delete the collection.  
    collectionToDelete.Delete_  

    ' Display change information.  
    Wscript.Echo "Deleted collection: " & collectionIDToDelete  

End Sub  

public void DeleteCollection(WqlConnectionManager connection, string collectionIDToDelete)  
{  
    //  Note:  On delete, the provider cleans up the SMS_CollectionSettings and SMS_CollectToSubCollect objects.  

    try  
    {  
        // Get the specific collection instance to delete.  
        IResultObject collectionToDelete = connection.GetInstance(@"SMS_Collection.CollectionID='" + collectionIDToDelete + "'");  

        // Delete the collection.  
        collectionToDelete.Delete();  

        // Output the ID of the deleted collection.  
        Console.WriteLine("Deleted collection: " + collectionIDToDelete);  
    }  

    catch (SmsException ex)  
    {  
        Console.WriteLine("Failed to delete collection. Error: " + ex.Message);  
        throw;  
    }  
}  

Ukázková metoda má následující parametry:

Parametr	Typ	Popis
connection	-Spravované: WqlConnectionManager - VBScript: SWbemServices	Platné připojení k poskytovateli serveru SMS.
collectionIDToDelete	-Spravované: String -Vbscript: String	Jedinečné automaticky generované ID obsahující osm znaků. Další informace najdete v CollectionID tématu o vlastnosti serverové třídy služby WMI SMS_Collection.

Kompilace kódu

Příklad jazyka C# vyžaduje:

Obory názvů

Systému

System.collections.generic

System.componentmodel

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Sestavení

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

Robustní programování

Další informace o zpracování chyb najdete v tématu Informace o chybách Configuration Manager.

Zabezpečení rozhraní .NET Framework

Další informace o zabezpečení Configuration Manager aplikací najdete v tématu Configuration Manager správa na základě rolí.

Viz taky

Serverová třída služby WMI SMS_Collection
Odstranění kolekcePřehled distribuce softwaruOnasazeních – Přehled objektůJak se připojit k poskytovateli Configuration Manager pomocí spravovaného kódu
Připojení k poskytovateli Configuration Manager pomocí rozhraní WMI