Een implementatie maken

Artikel
04/04/2023

In de volgende voorbeelden ziet u hoe u een Configuration Manager-implementatie maakt met de klasse SMS_Advertisement en de bijbehorende eigenschappen.

Belangrijk

Het account waarmee de implementatie wordt gemaakt, heeft de machtiging Pakketten implementeren voor de verzameling en de machtiging Lezen voor het pakket nodig.

Overzicht

Een verbinding met de SMS-provider instellen.
Maak een nieuw object van de SMS_Advertisement klasse.
Vul de nieuwe advertentie-eigenschappen in.
Sla de nieuwe advertentie en eigenschappen op.

Voorbeelden

In de volgende voorbeelden wordt een advertentie gemaakt voor softwaredistributie.

Zie Codefragmenten aanroepen Configuration Manager voor meer informatie over het aanroepen van de voorbeeldcode.

Sub SWDCreateAdvertisement(connection, existingCollectionID, existingPackageID, existingProgramName, newAdvertisementName, newAdvertisementComment, newAdvertisementFlags, newRemoteClientFlags, newAdvertisementStartOfferDateTime, newAdvertisementStartOfferEnabled)  
    Dim newAdvertisement  
    ' Create the new advertisement object.  
    Set newAdvertisement = connection.Get("SMS_Advertisement").SpawnInstance_  

    ' Populate the advertisement properties.  
    newAdvertisement.CollectionID = existingCollectionID  
    newAdvertisement.PackageID = existingPackageID  
    newAdvertisement.ProgramName = existingProgramName  
    newAdvertisement.AdvertisementName = newAdvertisementName  
    newAdvertisement.Comment = newAdvertisementComment  
    newAdvertisement.AdvertFlags = newAdvertisementFlags  
    newAdvertisement.RemoteClientFlags = newRemoteClientFlags
    newAdvertisement.PresentTime = newAdvertisementStartOfferDateTime  
    newAdvertisement.PresentTimeEnabled = newAdvertisementStartOfferEnabled  

    ' Save the new advertisement and properties.  
    newAdvertisement.Put_   

    ' Output new advertisement name.  
    Wscript.Echo "Created advertisement: " & newAdvertisement.AdvertisementName  

End Sub

public void CreateSWDAdvertisement(WqlConnectionManager connection, string existingCollectionID, string existingPackageID, string existingProgramName, string newAdvertisementName, string newAdvertisementComment, int newAdvertisementFlags, int newRemoteClientFlags, string newAdvertisementStartOfferDateTime, bool newAdvertisementStartOfferEnabled)  
{  
    try  
    {  
        // Create new advertisement instance.  
        IResultObject newAdvertisement = connection.CreateInstance("SMS_Advertisement");  

        // Populate new advertisement values.  
        newAdvertisement["CollectionID"].StringValue = existingCollectionID;  
        newAdvertisement["PackageID"].StringValue = existingPackageID;  
        newAdvertisement["ProgramName"].StringValue = existingProgramName;  
        newAdvertisement["AdvertisementName"].StringValue = newAdvertisementName;  
        newAdvertisement["Comment"].StringValue = newAdvertisementComment;  
        newAdvertisement["AdvertFlags"].IntegerValue = newAdvertisementFlags;  
        newAdvertisement["RemoteClientFlag"].IntegerValue = newRemoteClientFlags;
        newAdvertisement["PresentTime"].StringValue = newAdvertisementStartOfferDateTime;  
        newAdvertisement["PresentTimeEnabled"].BooleanValue = newAdvertisementStartOfferEnabled;  

        // Save the new advertisement and properties.  
        newAdvertisement.Put();  

        // Output new assignment name.  
        Console.WriteLine("Created advertisement: " + newAdvertisement["AdvertisementName"].StringValue);  
    }  

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

De voorbeeldmethode heeft de volgende parameters:

Parameter	Type	Beschrijving
`connection` `swbemServices`	-Beheerd: `WqlConnectionManager` - VBScript: SWbemServices	Een geldige verbinding met de SMS-provider.
`existingCollectionID`	Tekenreeks	De id van een bestaande verzameling waaraan de advertentie moet worden gekoppeld.
`existingPackageID`	Tekenreeks	De id van een bestaand pakket waaraan de advertentie moet worden gekoppeld.
`existingProgramName`	Tekenreeks	De naam van het programma dat aan de advertentie is gekoppeld.
`newAdvertisementName`	Tekenreeks	De naam van de nieuwe advertentie.
`newAdvertisementComment`	Tekenreeks	Een opmerking voor de nieuwe advertentie.
`newAdvertisementFlags`	Geheel getal	Vlaggen waarmee opties voor de nieuwe advertentie worden opgegeven.
`newRemoteClientFlags`	Geheel getal	Vlaggen die aangeven hoe het programma moet worden uitgevoerd wanneer de client lokaal of extern verbinding maakt met een distributiepunt.
`newAdvertisementStartOfferDateTime`	Tekenreeks	Het tijdstip waarop de nieuwe advertentie voor het eerst wordt aangeboden.
`newAdvertisementStartOfferEnabled`	Booleaanse waarde	`true` als de advertentie wordt aangeboden.

De code compileren

Voor het C#-voorbeeld is het volgende vereist:

Naamruimten

System
Microsoft.ConfigurationManagement.ManagementProvider
Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Vergadering

adminui.wqlqueryengine
microsoft.configurationmanagement.managementprovider
mscorlib

Robuust programmeren

Zie Over Configuration Manager fouten voor meer informatie over foutafhandeling.

Delen via