Erstellen einer Bereitstellung

Artikel
04/04/2023

Die folgenden Beispiele zeigen, wie Sie eine Configuration Manager Bereitstellung mit der SMS_Advertisement-Klasse und ihren Eigenschaften erstellen.

Wichtig

Das Konto, das die Bereitstellung erstellt, benötigt die Berechtigung Pakete bereitstellen für die Sammlung und Leseberechtigung für das Paket.

Übersicht

Richten Sie eine Verbindung mit dem SMS-Anbieter ein.
Erstellen Sie ein neues -Objekt der SMS_Advertisement -Klasse.
Füllen Sie die neuen Ankündigungseigenschaften auf.
Speichern Sie die neue Ankündigung und die neuen Eigenschaften.

Beispiele

In den folgenden Beispielen wird eine Ankündigung für die Softwareverteilung erstellt.

Weitere Informationen zum Aufrufen des Beispielcodes finden Sie unter Aufrufen von Configuration Manager Codeausschnitten.

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;  
    }  
}

Die Beispielmethode verfügt über die folgenden Parameter:

Parameter	Typ	Beschreibung
`connection` `swbemServices`	-Verwalteten: `WqlConnectionManager` – VBScript: SWbemServices	Eine gültige Verbindung mit dem SMS-Anbieter.
`existingCollectionID`	Zeichenfolge	Die ID einer vorhandenen Sammlung, der die Ankündigung zugeordnet werden soll.
`existingPackageID`	Zeichenfolge	Die ID eines vorhandenen Pakets, dem die Ankündigung zugeordnet werden soll.
`existingProgramName`	Zeichenfolge	Der Name des Programms, das der Ankündigung zugeordnet ist.
`newAdvertisementName`	Zeichenfolge	Der Name für die neue Ankündigung.
`newAdvertisementComment`	Zeichenfolge	Ein Kommentar für die neue Ankündigung.
`newAdvertisementFlags`	Ganzzahl	Flags, die Optionen für die neue Ankündigung angeben.
`newRemoteClientFlags`	Ganzzahl	Flags, die angeben, wie das Programm ausgeführt werden soll, wenn der Client entweder lokal oder remote eine Verbindung mit einem Verteilungspunkt herstellt.
`newAdvertisementStartOfferDateTime`	Zeichenfolge	Der Zeitpunkt, zu dem die neue Werbung zum ersten Mal angeboten wird.
`newAdvertisementStartOfferEnabled`	Boolesch	`true` , wenn die Anzeige angeboten wird.

Kompilieren des Codes

Für das C#-Beispiel ist Folgendes erforderlich:

Namespaces

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

Assembly

adminui.wqlqueryengine
microsoft.configurationmanagement.managementprovider
mscorlib

Robuste Programmierung

Weitere Informationen zur Fehlerbehandlung finden Sie unter Informationen zu Configuration Manager Fehlern.

Freigeben über