Comment créer un déploiement

Article
04/04/2023

Les exemples suivants montrent comment créer un déploiement Configuration Manager avec la classe SMS_Advertisement et ses propriétés.

Importante

Le compte qui crée le déploiement a besoin de l’autorisation Déployer des packages pour la collection et de l’autorisation Lecture pour le package.

Présentation

Configurez une connexion au fournisseur SMS.
Créez un objet de la SMS_Advertisement classe .
Remplissez les nouvelles propriétés de la publication.
Enregistrez la nouvelle publication et les nouvelles propriétés.

Exemples

Les exemples suivants créent une publication pour la distribution de logiciels.

Pour plus d’informations sur l’appel de l’exemple de code, consultez Appel d’extraits de code 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;  
    }  
}

L’exemple de méthode a les paramètres suivants :

Paramètre	Type	Description
`connection` `swbemServices`	-Géré: `WqlConnectionManager` - VBScript : SWbemServices	Connexion valide au fournisseur SMS.
`existingCollectionID`	String	ID d’une collection existante à laquelle associer la publication.
`existingPackageID`	String	ID d’un package existant auquel associer la publication.
`existingProgramName`	String	Nom du programme associé à la publicité.
`newAdvertisementName`	String	Nom de la nouvelle publicité.
`newAdvertisementComment`	String	Un commentaire pour la nouvelle annonce.
`newAdvertisementFlags`	Entier	Indicateurs spécifiant les options de la nouvelle publication.
`newRemoteClientFlags`	Entier	Indicateurs spécifiant la façon dont le programme doit s’exécuter lorsque le client se connecte localement ou à distance à un point de distribution.
`newAdvertisementStartOfferDateTime`	String	Heure à laquelle la nouvelle annonce est proposée pour la première fois.
`newAdvertisementStartOfferEnabled`	Boolean	`true` si la publicité est proposée.

Compilation du code

L’exemple C# nécessite :

Espaces de noms

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

Assembly

adminui.wqlqueryengine
microsoft.configurationmanagement.managementprovider
mscorlib

Programmation robuste

Pour plus d’informations sur la gestion des erreurs, consultez À propos des erreurs Configuration Manager.

Partage via