Como criar uma implantação

Artigo
04/04/2023

Os exemplos a seguir mostram como criar uma implantação de Configuration Manager com a classe SMS_Advertisement e suas propriedades.

Importante

A conta que cria a implantação precisa da permissão Implantar Pacotes para a coleção e a permissão de leitura para o pacote.

Visão geral

Configure uma conexão com o Provedor de SMS.
Crie um novo objeto da SMS_Advertisement classe.
Preencha as novas propriedades de anúncio.
Salve o novo anúncio e as propriedades.

Exemplos

Os exemplos a seguir criam um anúncio para distribuição de software.

Para obter mais informações sobre como chamar o código de exemplo, consulte Chamando Configuration Manager snippets de código.

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

O método de exemplo tem os seguintes parâmetros:

Parâmetro	Tipo	Descrição
`connection` `swbemServices`	-Gerenciado: `WqlConnectionManager` - VBScript: SWbemServices	Uma conexão válida com o provedor de SMS.
`existingCollectionID`	Cadeia de caracteres	A ID de uma coleção existente com a qual associar o anúncio.
`existingPackageID`	Cadeia de caracteres	A ID de um pacote existente com o qual associar o anúncio.
`existingProgramName`	Cadeia de caracteres	O nome do programa associado ao anúncio.
`newAdvertisementName`	Cadeia de caracteres	O nome do novo anúncio.
`newAdvertisementComment`	Cadeia de caracteres	Um comentário para o novo anúncio.
`newAdvertisementFlags`	Inteiro	Sinalizadores especificando opções para o novo anúncio.
`newRemoteClientFlags`	Inteiro	Sinalizadores especificando como o programa deve ser executado quando o cliente se conecta local ou remotamente a um ponto de distribuição.
`newAdvertisementStartOfferDateTime`	Cadeia de caracteres	A hora em que o novo anúncio é oferecido pela primeira vez.
`newAdvertisementStartOfferEnabled`	Boolean	`true` se o anúncio for oferecido.

Compilando o código

O exemplo C# requer:

Namespaces

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

Assembly

adminui.wqlqueryengine
microsoft.configurationmanagement.managementprovider
mscorlib

Programação robusta

Para obter mais informações sobre o tratamento de erros, consulte Sobre Configuration Manager erros.

Compartilhar via