Come creare una distribuzione

  • Articolo

Gli esempi seguenti illustrano come creare una distribuzione Configuration Manager con la classe SMS_Advertisement e le relative proprietà.

Importante

L'account che crea la distribuzione richiede l'autorizzazione Distribuisci pacchetti per la raccolta e l'autorizzazione Lettura per il pacchetto.

Panoramica

  1. Configurare una connessione al provider SMS.

  2. Creare un nuovo oggetto della SMS_Advertisement classe .

  3. Popolare le nuove proprietà dell'annuncio.

  4. Salvare il nuovo annuncio e le nuove proprietà.

Esempi

Gli esempi seguenti creano un annuncio per la distribuzione del software.

Per altre informazioni sulla chiamata del codice di esempio, vedere Chiamata di frammenti di codice Configuration Manager.

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

Il metodo di esempio include i parametri seguenti:

Parametro Tipo Descrizione
connection

swbemServices		 -Gestito: WqlConnectionManager
- VBScript: SWbemServices		 Connessione valida al provider SMS.
existingCollectionID Stringa ID di una raccolta esistente a cui associare l'annuncio.
existingPackageID Stringa ID di un pacchetto esistente a cui associare l'annuncio.
existingProgramName Stringa Nome del programma associato all'annuncio.
newAdvertisementName Stringa Nome del nuovo annuncio.
newAdvertisementComment Stringa Commento per il nuovo annuncio.
newAdvertisementFlags Numero intero Flag che specificano le opzioni per il nuovo annuncio.
newRemoteClientFlags Numero intero Flag che specificano la modalità di esecuzione del programma quando il client si connette in locale o in remoto a un punto di distribuzione.
newAdvertisementStartOfferDateTime Stringa Ora in cui viene offerto per la prima volta il nuovo annuncio.
newAdvertisementStartOfferEnabled Booleano true se l'annuncio è offerto.

Compilazione del codice

L'esempio C# richiede:

Namespaces

  • System

  • Microsoft.ConfigurationManagement.ManagementProvider

  • Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

  • adminui.wqlqueryengine

  • microsoft.configurationmanagement.managementprovider

  • mscorlib

Programmazione affidabile

Per altre informazioni sulla gestione degli errori, vedere Informazioni sugli errori di Configuration Manager.

Vedere anche