Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La SMS_Program classe Strumentazione gestione Windows (WMI) è una classe server del provider SMS, in Configuration Manager, che rappresenta un programma o un comando da eseguire quando il software viene distribuito a un computer client.
La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate.
Sintassi
Class SMS_Program : SMS_BaseClass
{
UInt32 ActionInProgress;
String ApplicationHierarchy;
String CommandLine;
String Comment;
String DependentProgram;
String Description;
UInt32 DeviceFlags;
String DiskSpaceReq;
String DriveLetter;
UInt32 Duration;
UInt8 ExtendedData[];
UInt32 ExtendedDataSize;
UInt8 Icon[];
UInt32 IconSize;
UInt8 ISVData[];
UInt32 ISVDataSize;
String ISVString;
String MSIFilePath
String MSIProductID
String PackageID;
String PackageName
UInt32 PackageType
String PackageVersion
UInt32 ProgramFlags;
String ProgramName;
String RemovalKey;
String Requirements;
UInt32 SecuredTypeID
SMS_OS_Details SupportedOperatingSystems[];
UInt32 TransformReadiness=0;
Datetime TransformAnalysisDate;
String TransformDtID;
String WorkingDirectory;
};
Metodi
La SMS_Program classe non definisce alcun metodo.
Proprietà
ActionInProgress Tipo: UInt32
Tipo di accesso: sola lettura
Qualificatori: [lettura, enumerazione]
Azione corrente in esecuzione sul pacchetto associato al programma da Configuration Manager. I valori possibili sono:
| Valore | Descrizione |
|---|---|
| 0 | NESSUNO |
| 1 | AGGIORNAMENTO |
| 2 | AGGIUNGI |
| 3 | ELIMINARE |
Usare questa proprietà in una clausola WHERE per filtrare i programmi contrassegnati per l'eliminazione ma non ancora eliminati. Per altre informazioni, vedere la sezione Osservazioni più avanti in questo argomento.
ApplicationHierarchy Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: Nessuna
Gerarchia di applicazioni per il programma. Il valore predefinito è "".
CommandLine Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: Nessuna
Riga di comando eseguita all'avvio del programma. Il valore predefinito è "".
Comment Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: Nessuna
Commento che descrive il programma nella console di Configuration Manager. Il valore predefinito è "".
DependentProgram Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: Nessuna
Stringa di testo formattata che definisce qualsiasi programma che deve essere eseguito prima di eseguire questo programma. Il formato è definito come <PackageID>;<ProgramName>. Se il programma è nello stesso pacchetto, l'applicazione chiamante può semplicemente specificare ;;<ProgramName>. Il valore predefinito è "".
La dipendenza viene mantenuta solo per la prima esecuzione del programma. Dopo l'esecuzione del programma, la dipendenza viene ignorata. Ad esempio, non è possibile creare un processo pianificato ricorrente per il quale viene mantenuta la dipendenza per ogni esecuzione del programma.
Description Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: Nessuna
Non utilizzata.
DeviceFlags Tipo: UInt32
Tipo di accesso: lettura/scrittura
Qualificazioni: Nessuna
Contrassegni che descrivono il dispositivo associato al programma. I valori possibili sono:
| Esadecimale (bit) | Descrizione |
|---|---|
| 0x01000000 (24) | Assegna sempre il programma al client. |
| 0x02000000 (25) | Assegnare solo se il dispositivo è attualmente connesso a una connessione a larghezza di banda elevata (impostazione predefinita superiore a 60 KBps). |
| 0x04000000 (26) | Assegnare solo se il dispositivo è ancorato, ovvero collegato a un desktop che usa ActiveSync. |
DiskSpaceReq Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: Nessuna
Spazio su disco approssimativo richiesto dal programma. Il formato è "<dimensione><KB|MB|GB".> Il valore predefinito è "".
Queste informazioni vengono utilizzate nella console di Configuration Manager e nell'annuncio per fornire avvisi sui requisiti di spazio su disco del programma. L'utente può quindi decidere di accettare l'annuncio o eseguire prima alcune attività di gestione del disco.
DriveLetter Tipo: String
Tipo di accesso: lettura/scrittura
Qualificatori: [SizeLimit("1"), Range("a-z")]
Lettera di unità (un carattere nell'intervallo A-Z) a cui il programma esegue il mapping e da cui viene eseguito. Il valore predefinito è "".
Duration Tipo: UInt32
Tipo di accesso: lettura/scrittura
Qualificazioni: Nessuna
Durata approssimativa, in minuti, dell'esecuzione del programma nel computer client. Specificare questo valore come numero intero maggiore o uguale a 0 (impostazione predefinita) o come Sconosciuto (scelta non consigliata). Se la proprietà è impostata su Sconosciuto, Configuration Manager imposta il tempo di esecuzione massimo consentito su 720 minuti (12 ore). Per altre informazioni, vedere la sezione Osservazioni più avanti in questo argomento.
Nota
Nei computer client, il valore specificato per i programmi pubblicati viene visualizzato nel Run Advertised Programs Pannello di controllo.
ExtendedData Tipo di dati: UInt8 matrice
Tipo di accesso: lettura/scrittura
Qualificatori: [grande, pigro]
BLOB XML per la distribuzione delle immagini.
ExtendedDataSize Tipo: UInt32
Tipo di accesso: lettura/scrittura
Qualificazioni: [pigro]
Dimensioni dei dati estesi, in byte. Il valore predefinito è 0.
Icon Tipo di dati: UInt8 matrice
Tipo di accesso: lettura/scrittura
Qualificazioni: [grande]
Informazioni sull'icona associata all'icona del programma, visualizzata nella console di Configuration Manager.
IconSize Tipo: UInt32
Tipo di accesso: lettura/scrittura
Qualificazioni: [pigro]
Dimensioni, in byte, dell'icona del programma. Impostare questa proprietà su 0 per cancellare l'icona.
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 SMS_Program oggetto.
Non esistono restrizioni o formati definiti per i dati ISV. Tuttavia, è importante non sovrascrivere la proprietà dopo che la proprietà dell'ISV è stata stabilita. L'applicazione deve prima leggere i dati esistenti in questa proprietà. Se i dati non appartengono all'applicazione, non devono essere modificati. È necessario includere un identificatore nei dati del programma in modo che la proprietà possa essere stabilita facilmente.
ISVDataSize Tipo: UInt32
Tipo di accesso: lettura/scrittura
Qualificazioni: [pigro]
Le dimensioni, in byte, dei dati archiviati in ISVData. Il valore predefinito è 0.
ISVString Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: nessuna
Stringa per l'estensibilità del partner.
MSIFilePath Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: Nessuna
Percorso del file del pacchetto di Windows Installer a cui è associato il programma. Il valore predefinito è "".
MSIProductID Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: Nessuna
ID prodotto del pacchetto di Windows Installer a cui è associato il programma. Il valore predefinito è "".
PackageID Tipo: String
Tipo di accesso: lettura/scrittura
Qualificatori: [chiave, Not_null]
ID di un pacchetto esistente a cui associare il programma. Per altre informazioni, vedere la sezione Osservazioni più avanti in questo argomento.
PackageName Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: [Nessuna]
Nome del pacchetto a cui appartiene il programma.
PackageType Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: [Nessuna]
Il tipo di pacchetto a cui appartiene il programma.
| Valore | Descrizione |
|---|---|
| 0 | Normale pacchetto di distribuzione software. |
| 3 | Pacchetto driver. |
| 4 | Pacchetto della sequenza di attività. |
| 5 | Pacchetto di aggiornamento del software. |
| 6 | Pacchetto di impostazione dei dispositivi. |
| 257 | Pacchetto immagine. |
| 258 | Pacchetto di immagine di avvio. |
| 259 | Sistema operativo. |
PackageVersion Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: [Nessuna]
Versione del pacchetto a cui appartiene il programma.
ProgramFlags Tipo: UInt32
Tipo di accesso: lettura/scrittura
Qualificatori: [bit]
Flag che identificano le caratteristiche di installazione del programma. I valori possibili sono elencati di seguito. I valori predefiniti sono EVERYUSER, USEUNCPATH, USERCONTEXT e UNPREDD.
Nota
Quando si usa SMS_Program a livello di codice, assicurarsi che non siano selezionati valori in conflitto. Ad esempio, NOUSERLOGGEDIN e USERCONTEXT non devono essere usati insieme.
I valori possibili sono:
| Esadecimale (bit) | Descrizione |
|---|---|
| 0x00000001 (0) | AUTHORIZED_DYNAMIC_INSTALL. Il programma è autorizzato per l'installazione dinamica. |
| 0x00000002 (1) | USECUSTOMPROGRESSMSG. La sequenza di attività mostra un messaggio personalizzato dell'interfaccia utente di stato. |
| 0x00000010 (4) | DEFAULT_PROGRAM. Questo è un programma predefinito |
| 0x00000020 (5) | DISABLEMOMALERTONRUNNING. Disabilita gli avvisi MOM durante l'esecuzione del programma. |
| 0x00000040 (6) | MOMALERTONFAIL. Genera un avviso MOM se il programma non riesce. |
| 0x00000080 (7) | RUN_DEPENDANT_ALWAYS. Se impostato, il dipendente immediato di questo programma dovrebbe essere sempre eseguito. |
| 0x00000100 (8) | WINDOWS_CE. Indica un programma di dispositivo. Se impostato, il programma non è offerto ai client desktop. |
| 0x00000200 (9) | Questo valore non viene usato. |
| 0x00000400 (10) | CONTO ALLA ROVESCIA. La finestra di dialogo del conto alla rovescia non viene visualizzata. |
| 0x00000800 (11) | FORZARERUN. Questo valore non viene usato. |
| 0x00001000 (12) | DISABILITATO. Il programma è disabilitato. |
| 0x00002000 (13) | INCUSTODITO. Il programma non richiede alcuna interazione da parte dell'utente. |
| 0x00004000 (14) | USERCONTEXT. Il programma può essere eseguito solo quando un utente è connesso. |
| 0x00008000 (15) | DIRITTI DI AMMINISTRATORE. Il programma deve essere eseguito con l'account dell'amministratore locale. |
| 0x00010000 (16) | OGNI UTENTE. Il programma deve essere eseguito da tutti gli utenti per i quali è valido. Valido solo per i lavori obbligatori. |
| 0x00020000 (17) | NOUSERLOGGEDIN. Il programma viene eseguito solo quando nessun utente è connesso. |
| 0x00040000 (18) | OKTOQUIT. Il programma riavvierà il computer. |
| 0x00080000 (19) | OKTOREBOOT. Configuration Manager riavvia il computer al termine dell'esecuzione del programma. |
| 0x00100000 (20) | USEUNCPATH. Usare un percorso UNC (nessuna lettera di unità) per accedere al punto di distribuzione. |
| 0x00200000 (21) | PERSIST. Mantiene la connessione all'unità specificata nella proprietà DriveLetter. Il flag di bit USEUNCPATH non deve essere impostato. |
| 0x00400000 (22) | RUNMINIMIZED. Esegui il programma come una finestra ridotta a icona. |
| 0x00800000 (23) | RUNMAXIMIZED. Esegui il programma come una finestra ingrandita. |
| x01000000 (24) | HIDEWINDOW. Nascondere la finestra del programma. |
| 0x02000000 (25) | OKTOLOGOFF. Disconnetti l'utente quando il programma viene completato correttamente. |
| 0x04000000 (26) | ESEGUIACCOUNT. Questo valore non viene usato. |
| 0x08000000 (27) | ANY_PLATFORM. Ignorare il controllo per il supporto della piattaforma. |
| 0x10000000 (28) | STILL_RUNNING. Questo valore non viene usato. |
| 0x20000000 (29) | SUPPORT_UNINSTALL. Eseguire la disinstallazione dalla chiave del Registro di sistema alla scadenza dell'annuncio. |
| 0x40000000 (30) | La piattaforma non è supportata. |
| 0x80000000 (31) | SHOW_IN_ARP. Questo valore non viene usato. |
ProgramName Tipo: String
Tipo di accesso: lettura/scrittura
Qualificatori: [chiave, Not_null]
Nome univoco che rappresenta il programma.
RemovalKey Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: Nessuna
Chiave del Registro di sistema che identifica lo script di disinstallazione per il programma. Lo script deve trovarsi nel percorso del HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall Registro di sistema. Il valore predefinito è "".
Requirements Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: Nessuna
Descrizione di eventuali requisiti aggiuntivi del programma. Il valore predefinito è "".
SecuredTypeID Tipo: UInt32
Tipo di accesso: lettura/scrittura
Qualificazioni: [Nessuna]
Tipo protetto di pacchetto correlato.
SupportedOperatingSystems Tipo di dati: SMS_OS_Details matrice
Tipo di accesso: lettura/scrittura
Qualificazioni: [pigro]
SMS_OS_Details oggetti della classe WMI del server che rappresentano i sistemi operativi in cui è possibile eseguire il programma.
Se non si specifica ANY_PLATFORM nella ProgramFlags proprietà, è necessario specificare uno o più sistemi operativi supportati.
SMS_SupportedPlatforms classe WMI del server definisce l'elenco delle piattaforme supportate da Configuration Manager.
TransformAnalysisDate Tipo: DateTime
Tipo di accesso: lettura/scrittura
Qualificazioni: [Nessuna]
Solo per uso interno.
TransformDtID Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: [Nessuna]
Solo per uso interno.
TransformReadiness Tipo: UInt32
Tipo di accesso: lettura/scrittura
Qualificazioni: [Nessuna]
Solo per uso interno.
WorkingDirectory Tipo: String
Tipo di accesso: lettura/scrittura
Qualificazioni: Nessuna
Percorso da cui viene eseguito il programma. Il valore predefinito è "".
La directory di lavoro può essere un percorso assoluto nel client o un percorso relativo alla cartella del punto di distribuzione che contiene il pacchetto. Se non viene specificata una directory di lavoro, Configuration Manager usa la cartella del punto di distribuzione predefinita.
Osservazioni
Non ci sono qualificazioni di classe speciali per questa classe. 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.
Un programma è sempre associato a un pacchetto padre e in genere rappresenta il programma di installazione per il pacchetto. È possibile associare più programmi allo stesso pacchetto. L'applicazione utilizza la PackageID proprietà per creare questa associazione. L'applicazione non può modificare questa proprietà dopo la creazione dell'oggetto SMS_Program . Per associare il programma a un pacchetto diverso, l'applicazione deve eliminare l'oggetto e creare un nuovo oggetto con un nuovo PackageID valore.
Quando l'applicazione elimina un SMS_Program oggetto, non viene eliminato fino a quando non vengono eliminati i componenti correlati, ad esempio gli annunci pubblicitari. Configuration Manager imposta invece la ActionInProgress proprietà su DELETE (3) per contrassegnare il programma per l'eliminazione. Per assicurarsi che una query non recuperi programmi contrassegnati per l'eliminazione, aggiungere questo case alla clausola WHERE.
Importante
Se si usano finestre di manutenzione per la raccolta in cui viene eseguito il programma, può verificarsi un conflitto se il Duration valore della proprietà è più lungo della finestra di manutenzione pianificata. Se questa proprietà è impostata su Sconosciuto, il programma viene avviato durante la finestra di manutenzione, ma continua a essere eseguito fino al completamento o all'esito negativo dopo la chiusura della finestra di manutenzione.
È consigliabile non impostare la Duration proprietà su Unknown perché viene utilizzata per i due scopi principali seguenti:
Per monitorare i risultati del programma.
Determinare se il programma verrà avviato quando sono state definite le finestre di manutenzione nei computer client.
Se l'applicazione imposta la proprietà ma il
Durationtempo di esecuzione del programma supera questa durata, Configuration Manager interrompe il monitoraggio del programma ma non termina il programma. In questo modo Configuration Manager può continuare con altre funzioni di distribuzione software, ad esempio l'esecuzione di altri programmi pubblicizzati. Il gestore non:Arresta il programma.
Liberare tutte le unità mappate per il programma pubblicizzato.
Libera qualsiasi connessione di rete effettuata per il programma pubblicizzato.
Risorse gratuite del sistema operativo usate da Configuration Manager quando sono in esecuzione programmi annunciati.
Per ulteriori informazioni, vedere Informazioni sulle finestre di manutenzione.
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.
Vedere anche
SMS_Package classe WMI del serverCome creare un pacchettoCome creare un programma