classe WMI del server SMS_Advertisement

La SMS_Advertisement classe Strumentazione gestione Windows (WMI) è una classe server del provider SMS in Configuration Manager che rappresenta un annuncio pubblicitario utilizzato per annunciare i programmi di pacchetti software disponibili per l'esecuzione sui client.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate.

Sintassi

Class SMS_Advertisement : SMS_BaseClass
{
      UInt32 ActionInProgress;
      UInt32 AdvertFlags;
      String AdvertisementID;
      String AdvertisementName;
      SMS_ScheduleToken AssignedSchedule[];
      Boolean AssignedScheduleEnabled;
      Boolean AssignedScheduleIsGMT;
      UInt32 AssignmentID;
      String CollectionID;
      String Comment;
      UInt32 DeviceFlags;
      DateTime ExpirationTime;
      Boolean ExpirationTimeEnabled;
      Boolean ExpirationTimeIsGMT;
      String HierarchyPath;
      Boolean IncludeSubCollection;
      UInt8 ISVData[];
      UInt32 ISVDataSize;
      String ISVString;
      UInt32 MandatoryCountdown;
      UInt32 OfferType;
      String PackageID;
      DateTime PresentTime;
      Boolean PresentTimeEnabled;
      Boolean PresentTimeIsGMT;
      UInt32 Priority;
      String ProgramName;
      UInt32 RemoteClientFlags;
      String SourceSite;
      UInt32 TimeFlags;
};

Metodi

Nella tabella seguente sono elencati i metodi della SMS_Advertisement classe.

Proprietà

ActionInProgress

Tipo di dati:UInt32

Tipo di accesso: sola lettura

Qualificatori: [lettura, enumerazione]

Azione corrente in esecuzione sul pacchetto da parte di Configuration Manager. I valori possibili sono:

AdvertFlags

Tipo di dati:UInt32

Tipo di accesso: lettura/scrittura

Qualificatori: [bit]

Flag che indicano come annunciare l'annuncio all'utente. I valori possibili sono elencati di seguito. Il valore predefinito è 0.

Questi flag devono essere coordinati con i flag specificati nella ProgramFlags proprietà del programma annunciato. Ad esempio, se si imposta ONUSERLOGOFF, è necessario impostare il flag NOUSERLOGGEDIN nel programma. Se le impostazioni dei contrassegni non corrispondono, il programma non viene annunciato. Per ulteriori informazioni, vedere SMS_Program Server WMI Class.

L'impostazione di IMMEDIATE, ONUSERLOGON o ONUSERLOGOFF o di un AssignedSchedule valore rende obbligatorio il programma annunciato. Un programma obbligatorio viene eseguito automaticamente dopo che il cliente ha ricevuto l'annuncio. Il cliente non può rifiutare o posticipare l'installazione.

Impostare i bit NO_DISPLAY e ONSLOWNET solo quando è impostato il bit IMMEDIATE, ONUSERLOGON o ONUSERLOGOFF o il programma ha un AssignedSchedule valore.

Impostare NO_DISPLAY quando non si vuole che l'utente esegua programmi indipendentemente dall'assegnazione. Se non si imposta questo flag, l'annuncio viene visualizzato nell'elenco degli annunci e può essere eseguito indipendentemente dall'assegnazione. Il programma può ancora essere obbligatorio.

Impostare ONSLOWNET quando le assegnazioni sono obbligatorie su una connessione di rete lenta, ad esempio quando un computer si connette utilizzando un modem.

AdvertisementID

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificatori: [key, ResID(801), ResDLL("SMS_RSTT.dll")]

Chiave unica generata automaticamente che identifica l'annuncio. Il valore predefinito è "".

AdvertisementName

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificazioni: [Not_null]

Nome univoco descrittivo per l'annuncio.

AssignedSchedule Tipo di dati: SMS_ScheduleToken matrice

Tipo di accesso: lettura/scrittura

Qualificazioni: [max(15), lazy]

SMS_ScheduleToken oggetti della classe WMI del server che indicano l'ora in cui l'annuncio diventa obbligatorio per i client.

AssignedScheduleEnabled

Tipo di dati:Boolean

Tipo di accesso: lettura/scrittura

Qualificazioni: [pigro]

true se la AssignedSchedule pianificazione definita nella proprietà è attiva. Il valore predefinito è false.

AssignedScheduleIsGMT

Tipo di dati:Boolean

Tipo di accesso: lettura/scrittura

Qualificazioni: [pigro]

true se la AssignedSchedule pianificazione definita nella proprietà è in formato UMT (Universal Metric Time). Il valore predefinito è false.

AssignmentID

Tipo di dati:UInt32

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

ID dell'attività associata all'annuncio.

CollectionID

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificazioni: [Not_null]

Raccolta esistente a cui è destinato l'annuncio.

Comment

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificazioni: Nessuna

Descrizione semplice o nota sull'annuncio. Il valore predefinito è "".

DeviceFlags

Tipo di dati:UInt32

Tipo di accesso: lettura/scrittura

Qualificazioni: Nessuna

Contrassegni che descrivono il dispositivo. I valori possibili sono elencati di seguito. Il valore predefinito è 0.

ExpirationTime

Tipo di dati:DateTime

Tipo di accesso: lettura/scrittura

Qualificazioni: Nessuna

Data e ora in cui l'annuncio non è più disponibile per i clienti. Il valore predefinito è 19900101000000.000000+****.

ExpirationTimeEnabled

Tipo di dati:Boolean

Tipo di accesso: lettura/scrittura

Qualificazioni: [pigro]

true se l'annuncio scade all'ora indicata dalla ExpirationTime proprietà. Il valore predefinito è false.

ExpirationTimeIsGMT

Tipo di dati:Boolean

Tipo di accesso: lettura/scrittura

Qualificazioni: [pigro]

true se l'ora ExpirationTime definita nella proprietà è in UMT. Il valore predefinito è false.

HierarchyPath

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificazioni: Nessuna

Riservato.

IncludeSubCollection

Tipo di dati:Boolean

Tipo di accesso: lettura/scrittura

Qualificazioni: Nessuna

true (impostazione predefinita) se l'annuncio è pubblicizzato per le sottocollezioni della raccolta specificata.

ISVData

Tipo di dati: Uint8 matrice

Tipo di accesso: lettura/scrittura

Qualificatori: [grande, pigro]

Informazioni che consentono a un singolo ISV di archiviare i dati relativi a un'istanza SMS_Program . Non ci sono restrizioni o formati definiti per questi dati. Tuttavia, è importante non sovrascrivere la proprietà dopo che è stata stabilita la proprietà dell'ISV. Di conseguenza, l'applicazione chiamante deve prima leggere i dati esistenti in questa proprietà. Se i dati non appartengono all'applicazione, non devono essere modificati. Qualsiasi ISV o proprietario dell'applicazione che usa questa proprietà deve includere un identificatore nei dati in modo che la proprietà possa essere facilmente stabilita.

ISVDataSize

Tipo di dati:UInt32

Tipo di accesso: lettura/scrittura

Qualificazioni: [pigro]

Dimensioni dei dati rappresentati dalla ISVData proprietà. Il valore predefinito è 0.

ISVString

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificazioni: nessuna

Stringa per l'estensibilità del partner.

MandatoryCountdown

Tipo di dati:UInt32

Tipo di accesso: lettura/scrittura

Qualificazioni: Nessuna

Durata, in minuti, per visualizzare la notifica dell'utente per la distribuzione del sistema operativo Conto alla rovescia della pianificazione obbligatoria. Il valore predefinito è 0.

OfferType

Tipo di dati:UInt32

Tipo di accesso: lettura/scrittura

Qualificatori: [enumerazione]

Tipo di annuncio che indica che l'annuncio è destinato agli utenti.

PackageID

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificazioni: [Not_null]

ID di un pacchetto esistente associato all'annuncio. Il valore deve essere in maiuscolo.

PresentTime

Tipo di dati:DateTime

Tipo di accesso: lettura/scrittura

Qualificazioni: Nessuna

Data e ora in cui l'annuncio è reso disponibile ai clienti. Il valore predefinito è 19900101000000.000000+****.

PresentTimeEnabled

Tipo di dati:Boolean

Tipo di accesso: lettura/scrittura

Qualificazioni: [pigro]

true(impostazione predefinita) se l'ora attuale è applicata da Configuration Manager.

PresentTimeIsGMT

Tipo di dati:Boolean

Tipo di accesso: lettura/scrittura

Qualificazioni: [pigro]

true se l'ora PresentTime definita nella proprietà è in UMT. Il valore predefinito è false.

Priority

Tipo di dati:UInt32

Tipo di accesso: lettura/scrittura

Qualificatori: [enumerazione]

Priorità utilizzata per replicare l'annuncio nei siti figlio. I valori possibili sono elencati di seguito. Il valore predefinito è NORMAL (2).

ProgramName

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificazioni: [Not_null]

Un programma all'interno del pacchetto specificato (PackageID) da annunciare.

RemoteClientFlags

Tipo di dati:UInt32

Tipo di accesso: lettura/scrittura

Qualificatori: [bit]

Flag che specificano la modalità di esecuzione del programma quando il client è connesso in locale o in remoto a un punto di distribuzione. I valori possibili sono elencati di seguito. Il valore predefinito è 48.

SourceSite

Tipo di dati:String

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

Codice sito di tre lettere del sito in cui ha origine l'annuncio.

TimeFlags

Tipo di dati:UInt32

Tipo di accesso: sola lettura

Qualificatori: [leggi, bit]

Riservato all'uso interno. Flag che duplicano le informazioni nelle proprietà correlate al tempo. I valori possibili sono elencati di seguito. Ad esempio, ENABLE_PRESENT viene impostato quando PresentTimeEnabled è uguale a true.

Osservazioni

I qualificatori della classe per questa classe includono:

• Protetto

  Per altre informazioni sui qualificatori di classe e sui qualificatori di proprietà inclusi nella sezione Proprietà, vedere Qualificatori di classe e proprietà di Configuration Manager.

  Anche se non esistono altre proprietà chiave, le proprietà AdvertisementName, CollectionID, PackageID, e ProgramName sono qualificate come NOT_NULL e i valori devono essere forniti. L'applicazione non può aggiornare queste proprietà dopo la creazione di un'istanza di classe. Per modificare questi valori, l'applicazione deve eliminare l'istanza e creare una nuova istanza con i valori corretti.

Requisiti

Requisiti di runtime

Per altre informazioni, vedere Configuration Manager Requisiti di runtime del server.

Requisiti di sviluppo

Per altre informazioni, vedere Requisiti di sviluppo del server di Configuration Manager.