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 programmi di pacchetti software disponibili per l'esecuzione nei 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 nella SMS_Advertisement classe .
| Metodo | Descrizione |
|---|---|
| Metodo GetAdvertisements nella classe SMS_Advertisement | Ottiene gli ID dell'annuncio destinati alla risorsa. |
| Metodo GetNextID nella classe SMS_Advertisement | Recupera il numero ID che verrà usato per l'annuncio successivo creato. |
| Metodo RiskyDeploymentStatusMessage nella classe SMS_Advertisement | Invia un messaggio di stato di avviso relativo a una distribuzione utente a una raccolta rischiosa. |
| Metodo SetNextID nella classe SMS_Advertisement | Imposta il numero ID che verrà usato per l'annuncio successivo creato. |
| Metodo SetSourceSite nella classe SMS_Advertisement | Imposta il codice del sito sorgente per l'annuncio. |
| Metodo Unlock nella classe SMS_Advertisement | Imposta il sito di origine sul sito corrente, sbloccando l'annuncio. Avviso: Questo metodo è deprecato. |
Proprietà
ActionInProgress
Tipo di dati:UInt32
Tipo di accesso: sola lettura
Qualificatori: [lettura, enumerazione]
Azione corrente eseguita sul pacchetto da Configuration Manager. I valori possibili sono:
| Valore | Descrizione |
|---|---|
| 0 | NESSUNO |
| 1 | AGGIORNAMENTO |
| 2 | Aggiungere |
AdvertFlags
Tipo di dati:UInt32
Tipo di accesso: lettura/scrittura
Qualificatori: [bits]
Flag che indicano come l'annuncio pubblicitario deve essere annunciato all'utente. Di seguito sono elencati i valori possibili. Il valore predefinito è 0.
| Esadecimale (bit) | Descrizione |
|---|---|
| 0x00000020 (5) | IMMEDIATO. Annunciare immediatamente l'annuncio all'utente. |
| 0x00000100 (8) | ONSYSTEMSTARTUP. Annunciare l'annuncio all'utente all'avvio del sistema. |
| 0x00000200 (9) | ONUSERLOGON. Annunciare l'annuncio all'utente all'accesso. |
| 0x00000400 (10) | ONUSERLOGOFF. Annunciare l'annuncio all'utente durante la disconnessione. |
| 0x00001000 (12) | OPTIONALPREDOWNLOAD. Se l'architettura e la lingua selezionate corrispondono a quella del client, il contenuto del pacchetto verrà scaricato in anticipo |
| 0x00008000 (15) | WINDOWS_CE. L'annuncio è per un client del dispositivo. |
| 0x00010000 (16) | ENABLE_PEER_CACHING. Queste informazioni si applicano a System Center 2012 Configuration Manager SP1 o versioni successive e System Center 2012 R2 Configuration Manager o versioni successive. |
| 0x00020000 (17) | DONOT_FALLBACK. Non eseguire il back dei punti di distribuzione non protetti. |
| 0x00040000 (18) | ENABLE_TS_FROM_CD_AND_PXE. La sequenza di attività è disponibile per i supporti rimovibili e il punto di servizio PXE (Pre-Boot Execution Environment). |
| 0x00080000 (19) | APTSINTRANETONLY. |
| 0x00100000 (20) | OVERRIDE_SERVICE_WINDOWS. Sostituire le finestre di manutenzione nell'annuncio dell'annuncio all'utente. |
| 0x00200000 (21) | REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Riavviare all'esterno delle finestre di manutenzione. |
| 0x00400000 (22) | WAKE_ON_LAN_ENABLED. Annunciare l'annuncio all'utente con riattivazione LAN abilitata. |
| 0x00800000 (23) | SHOW_PROGRESS. Annunciare l'annuncio all'utente che mostra lo stato di avanzamento della sequenza di attività. |
| 0x02000000 (25) | NO_DISPLAY. L'utente non deve eseguire programmi indipendentemente dall'assegnazione. |
| 0x04000000 (26) | ONSLOWNET. Le assegnazioni sono obbligatorie per una connessione di rete lenta. |
| 0x10000000 (28) | TARGETTOWINPE. Indirizzare questa distribuzione solo a WinPE. |
| 0x20000000 (29) | HIDDENINWINPE. Indirizzare questa distribuzione solo a WinPE, ma nasconderla in WinPE. Può essere usato solo dalla variabile TS SMSTSPreferredAdvertID. |
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 del flag non corrispondono, il programma non viene annunciato. Per altre informazioni, vedere SMS_Program Classe WMI del server.
Se si imposta IMMEDIATE, ONUSERLOGON o ONUSERLOGOFF o si specifica un AssignedSchedule valore, il programma annunciato è obbligatorio. Un programma obbligatorio viene eseguito automaticamente dopo che il client ha ricevuto l'annuncio. Il client non può rifiutare o posticipare l'installazione.
Impostare i bit NO_DISPLAY e ONSLOWNET solo quando il bit IMMEDIATE, ONUSERLOGON o ONUSERLOGOFF è impostato o il programma ha un AssignedSchedule valore.
Impostare NO_DISPLAY quando non si vuole che l'utente eservi 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ò essere ancora obbligatorio.
Impostare ONSLOWNET quando le assegnazioni sono obbligatorie su una connessione di rete lenta, ad esempio quando un computer si connette usando un modem.
AdvertisementID
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: [key, ResID(801), ResDLL("SMS_RSTT.dll")]
Chiave univoca generata automaticamente che identifica l'annuncio. Il valore predefinito è "".
AdvertisementName
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: [Not_null]
Nome descrittivo univoco per l'annuncio.
AssignedSchedule
Tipo di dati: SMS_ScheduleToken Matrice
Tipo di accesso: lettura/scrittura
Qualificatori: [max(15), lazy]
SMS_ScheduleToken oggetti classe WMI server che indicano l'ora in cui l'annuncio diventa obbligatorio nei client.
AssignedScheduleEnabled
Tipo di dati:Boolean
Tipo di accesso: lettura/scrittura
Qualificatori: [lazy]
true se la pianificazione definita nella AssignedSchedule proprietà è attiva. Il valore predefinito è false.
AssignedScheduleIsGMT
Tipo di dati:Boolean
Tipo di accesso: lettura/scrittura
Qualificatori: [lazy]
true se la pianificazione definita nella AssignedSchedule proprietà è in tempo umt (Universal Metric Time). Il valore predefinito è false.
AssignmentID
Tipo di dati:UInt32
Tipo di accesso: sola lettura
Qualificatori: [read]
ID dell'assegnazione associata all'annuncio.
CollectionID
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: [Not_null]
Raccolta esistente a cui è destinato l'annuncio.
Comment
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: Nessuno
Semplice descrizione o nota sull'annuncio. Il valore predefinito è "".
DeviceFlags
Tipo di dati:UInt32
Tipo di accesso: lettura/scrittura
Qualificatori: Nessuno
Flag che descrivono il dispositivo. Di seguito sono elencati i valori possibili. Il valore predefinito è 0.
| Esadecimale (bit) | Descrizione |
|---|---|
| 0x01000000 (24) | Assegnare sempre il programma al client. |
| 0x02000000 (25) | Assegna solo se il dispositivo è attualmente connesso a una connessione a larghezza di banda elevata (impostazione predefinita superiore a 60 KBps). |
| 0x04000000 (26) | Assegna solo se il dispositivo è ancorato, ovvero è collegato a un desktop che usa ActiveSync. |
ExpirationTime
Tipo di dati:DateTime
Tipo di accesso: lettura/scrittura
Qualificatori: Nessuno
Data e ora in cui l'annuncio non è più disponibile per i client. Il valore predefinito è 199001010000000.000000+****.
ExpirationTimeEnabled
Tipo di dati:Boolean
Tipo di accesso: lettura/scrittura
Qualificatori: [lazy]
true se l'annuncio scade nel momento indicato dalla ExpirationTime proprietà . Il valore predefinito è false.
ExpirationTimeIsGMT
Tipo di dati:Boolean
Tipo di accesso: lettura/scrittura
Qualificatori: [lazy]
true se l'ora definita nella ExpirationTime proprietà è in UMT. Il valore predefinito è false.
HierarchyPath
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: Nessuno
Riservati.
IncludeSubCollection
Tipo di dati:Boolean
Tipo di accesso: lettura/scrittura
Qualificatori: Nessuno
true (impostazione predefinita) se l'annuncio viene annunciato alle sottoraccolte 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 esistono restrizioni o formati definiti per questi dati. Tuttavia, è importante non sovrascrivere la proprietà dopo che è stata stabilita la proprietà ISV. Pertanto, 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
Qualificatori: [lazy]
Dimensioni dei dati rappresentati dalla ISVData proprietà . Il valore predefinito è 0.
ISVString
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: nessuno
Stringa per l'estendibilità del partner.
MandatoryCountdown
Tipo di dati:UInt32
Tipo di accesso: lettura/scrittura
Qualificatori: Nessuno
Durata, in minuti, per visualizzare il conto alla rovescia obbligatorio della pianificazione della distribuzione del sistema operativo. 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.
| Valore | Descrizione |
|---|---|
| 0 | Obbligatorio |
| 2 | Disponibile |
PackageID
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: [Not_null]
ID per un pacchetto esistente associato all'annuncio. Il valore deve essere in lettere maiuscole.
PresentTime
Tipo di dati:DateTime
Tipo di accesso: lettura/scrittura
Qualificatori: Nessuno
Data e ora in cui l'annuncio viene reso disponibile ai client. Il valore predefinito è 199001010000000.000000+****.
PresentTimeEnabled
Tipo di dati:Boolean
Tipo di accesso: lettura/scrittura
Qualificatori: [lazy]
true(impostazione predefinita) se l'ora corrente viene applicata da Configuration Manager.
PresentTimeIsGMT
Tipo di dati:Boolean
Tipo di accesso: lettura/scrittura
Qualificatori: [lazy]
true se l'ora definita nella PresentTime proprietà è in UMT. Il valore predefinito è false.
Priority
Tipo di dati:UInt32
Tipo di accesso: lettura/scrittura
Qualificatori: [enumerazione]
Priorità utilizzata per la replica dell'annuncio nei siti figlio. Di seguito sono elencati i valori possibili. Il valore predefinito è NORMAL (2).
| Valore | Descrizione |
|---|---|
| 1 | ALTO |
| 2 | NORMALE |
| 3 | Basso |
ProgramName
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: [Not_null]
Programma all'interno del pacchetto specificato (PackageID) da annunciare.
RemoteClientFlags
Tipo di dati:UInt32
Tipo di accesso: lettura/scrittura
Qualificatori: [bits]
Flag che specificano la modalità di esecuzione del programma quando il client è connesso in locale o in remoto a un punto di distribuzione. Di seguito sono elencati i valori possibili. Il valore predefinito è 48.
| Esadecimale (bit) | Descrizione |
|---|---|
| 0x00000001 (0) | BATTERY_POWER. Eseguire il programma usando l'alimentazione a batteria. Questo valore è attualmente inutilizzato. |
| 0x00000002 (1) | RUN_FROM_CD. Eseguire il programma da CD. Questo valore è attualmente inutilizzato. |
| 0x00000004 (2) | DOWNLOAD_FROM_CD. Scaricare il programma da CD. Questo valore è attualmente inutilizzato. |
| 0x00000008 (3) | RUN_FROM_LOCAL_DISPPOINT. Eseguire il programma dal punto di distribuzione locale. |
| 0x00000010 (4) | DOWNLOAD_FROM_LOCAL_DISPPOINT. Scaricare il programma dal punto di distribuzione locale. |
| 0x00000020 (5) | DONT_RUN_NO_LOCAL_DISPPOINT. Non eseguire il programma se non è presente alcun punto di distribuzione locale. |
| 0x00000040 (6) | DOWNLOAD_FROM_REMOTE_DISPPOINT. Scaricare il programma dal punto di distribuzione remoto. |
| 0x00000080 (7) | RUN_FROM_REMOTE_DISPPOINT. Eseguire il programma dal punto di distribuzione remoto. |
| 0x00000100 (8) | DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. Scaricare il programma su richiesta dal punto di distribuzione locale. Questo è applicabile solo per le sequenze di attività. |
| 0x00000200 (9) | DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. Scaricare il programma su richiesta dal punto di distribuzione remoto. Questo è applicabile solo per le sequenze di attività. |
| x00000400 (10) | BALLOON_REMINDERS_REQUIRED. Sono necessari promemoria per i palloncini. |
| 0x00000800 (11) | RERUN_ALWAYS. Eseguire sempre il programma. |
| 0x00001000 (12) | RERUN_NEVER. Non eseguire mai di nuovo il programma. |
| 0x00002000 (13) | RERUN_IF_FAILED. Eseguire nuovamente il programma se l'esecuzione non è riuscita in precedenza. |
| 0x00004000 (14) | RERUN_IF_SUCCEEDED. Eseguire nuovamente il programma se l'esecuzione è stata eseguita in precedenza. |
| 0x00008000 (15) | PERSIST_ON_WRITE_FILTER_DEVICES Queste informazioni si applicano a System Center 2012 Configuration Manager SP1 o versioni successive e System Center 2012 R2 Configuration Manager o versioni successive. |
| 0x00020000 (17) | DON'T_FALLBACK Queste informazioni si applicano a System Center 2012 Configuration Manager SP1 o versioni successive e System Center 2012 R2 Configuration Manager o versioni successive. |
| 0x00040000 (18) | DP_ALLOW_METERED_NETWORK Queste informazioni si applicano a System Center 2012 Configuration Manager SP1 o versioni successive e System Center 2012 R2 Configuration Manager o versioni successive. |
SourceSite
Tipo di dati:String
Tipo di accesso: sola lettura
Qualificatori: [read]
Codice del sito di tre lettere del sito in cui ha origine l'annuncio.
TimeFlags
Tipo di dati:UInt32
Tipo di accesso: sola lettura
Qualificatori: [read, bits]
Riservato per uso interno. Flag che duplicano le informazioni nelle proprietà correlate all'ora. Di seguito sono elencati i valori possibili. Ad esempio, ENABLE_PRESENT viene impostato quando PresentTimeEnabled è uguale truea .
| Esadecimale (bit) | Descrizione |
|---|---|
| 0x00000001 (0) | ENABLE_PRESENT |
| 0x00000002 (1) | ENABLE_EXPIRATION |
| 0x00000004 (2) | ENABLE_AVAILABLE |
| 0x00000008 (3) | ENABLE_UNAVAILABLE |
| 0x00000010 (4) | ENABLE_MANDATORY |
| 0x00000020 (5) | GMT_PRESENT |
| 0x00000040 (6) | GMT_EXPIRATION |
| 0x00000080 (7) | GMT_AVAILABLE |
| 0x00000100 (8) | GMT_UNAVAILABLE |
| 0x00000200 (9) | GMT_MANDATORY |
Osservazioni
I qualificatori di classe per questa classe includono:
Protetto
Per altre informazioni sui qualificatori di classe e sui qualificatori di proprietà inclusi nella sezione Proprietà, vedere Configuration Manager Qualificatori di classe e proprietà.
Anche se non sono presenti altre proprietà di chiave, le proprietà
AdvertisementName,CollectionID,PackageIDeProgramNamesono qualificate come NOT_NULL e i valori devono essere specificati. 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 Configuration Manager Requisiti di sviluppo del server.