Qualificatori di contesto Configuration Manager

Articolo
04/04/2023

Gli oggetti di contesto vengono usati, in Configuration Manager, per fornire informazioni aggiuntive al provider SMS. In genere, si usano i qualificatori di contesto per fornire al provider SMS informazioni contestuali, ad esempio il nome dell'applicazione. È possibile usare qualificatori di contesto quando ci si connette al provider SMS e con singoli oggetti provider SMS.

Codice gestito

Quando si usano le librerie del provider SMS gestito, si usa la proprietà ConnectionManagerBase.Context per specificare i qualificatori di contesto. Per altre informazioni, vedere Come aggiungere un qualificatore di contesto Configuration Manager usando codice gestito.

Vbscript

Quando si usa VBScript, si usa l'interfaccia SWBemNamedValue impostata per specificare qualificatori di contesto come raccolta di oggetti valore denominati. Per altre informazioni, vedere Come aggiungere un qualificatore di contesto Configuration Manager usando WMI.

Qualificatori di contesto

La tabella seguente contiene i qualificatori di contesto (valori denominati) usati dal provider SMS. La maggior parte dei qualificatori, ad esempio SessionHandle, viene usata solo con aree funzionali specifiche del provider SMS; ma LocaleID, MachineNamee ApplicationName sono destinate all'uso dell'applicazione.

Qualificatore di contesto	Descrizione
`ApplicationName`	Identifica l'applicazione che ha effettuato la chiamata.
`ContextHandle`	Identifica dove il provider SMS ha archiviato i qualificatori di contesto memorizzati nella cache.
`InstanceCount`	Limita il numero di istanze restituite da ExecQuery e CreateInstanceEnum.
`LimitToCollectionIDs`	Limita i risultati di una query di risorse ai membri delle raccolte denominate.
`LocaleID`	Identifica la tabella codici da utilizzare.
`MachineName`	Identifica il computer che esegue l'applicazione.
`QueryQualifiers`	Restituisce i flag di bit SecurityVerbs quando si eseguono query su oggetti protetti.
`SessionHandle`	Identifica la copia dell'applicazione del file di controllo del sito da Configuration Manager.

Applicationname

Il ApplicationName qualificatore di contesto è un valore stringa che identifica il nome dell'applicazione che ha effettuato la chiamata. È necessario specificare ApplicationName per l'applicazione perché viene usata per il controllo. Se non si specifica il nome dell'applicazione, viene usato il valore Sconosciuto. È necessario specificare il ApplicationName valore quando si chiama uno dei metodi del messaggio di stato di generazione, ad esempio SMS_StatusMessage::RaiseErrorStatusMsg, oppure la chiamata avrà esito negativo.

ContextHandle

Il ContextHandle qualificatore di contesto è un valore stringa che identifica dove il provider SMS ha archiviato i qualificatori di contesto memorizzati nella cache. Il provider SMS gestito gestisce il trasferimento dei dati. Quando si usa VBScript, è possibile usare la procedura seguente per ridurre la quantità di dati passati in rete.

Creare il set di valori SWBemNamedValue .
Aggiungere i qualificatori all'oggetto di contesto. Per altre informazioni, vedere Come aggiungere un qualificatore di contesto Configuration Manager usando WMI.
Chiamare il metodo GetContextHandle per memorizzare nella cache i qualificatori nel server. Il provider SMS memorizza nella cache l'oggetto di contesto passato come parametro di ExecMethod quando si chiama GetContextHandle.
Rimuovere tutti i qualificatori dall'oggetto di contesto.
Aggiungere il qualificatore e il valore all'oggetto ContextHandle di contesto.
Passare l'oggetto di contesto su tutte le chiamate a IWbemServices.

È necessario chiamare il metodo ClearContextHandle per rimuovere i qualificatori memorizzati nella cache prima di uscire dall'applicazione. È possibile creare tutti ContextHandle i valori desiderati, ognuno dei quali fornisce informazioni variabili per l'applicazione.

Nota

Dopo aver memorizzato nella cache i qualificatori di contesto, è possibile eseguire l'override dei valori memorizzati nella cache aggiungendo gli stessi qualificatori di contesto, con valori diversi, all'oggetto di contesto.

InstanceCount

Il InstanceCount qualificatore di contesto è un valore intero utilizzato per limitare il numero di istanze restituite dai metodi ExecQuery e CreateInstanceEnum . È possibile impostare InstanceCount il numero massimo di istanze restituite dalla query o dall'enumeratore. Ad esempio, l'impostazione su InstanceCount 10 restituisce, al massimo, 10 istanze.

LimitToCollectionIDs

Il LimitToCollectionIDs qualificatore di contesto è una matrice di stringhe che contiene un elenco di CollectionID valori. Attualmente, è possibile specificare un CollectionID solo valore. Usare questo qualificatore per limitare i risultati di una query di risorse ai membri della raccolta denominata. Una query di risorse è una query che include classi derivate da SMS_Resource o SMS_Group.

L'utente deve disporre delle autorizzazioni di lettura delle risorse di istanza per la raccolta a cui appartiene la risorsa. È necessario usare la limitazione della raccolta quando l'utente non dispone dei diritti di risorsa di lettura della classe per le raccolte; in caso contrario, non vengono restituiti dati. Per SMS 2.0 con Service Pack 1 e versioni successive, questa restrizione si applica solo alle classi derivate da SMS_Group.

Non è possibile usare questo qualificatore durante l'esecuzione di query sulle raccolte.

Localeid

Il LocaleID qualificatore di contesto è un valore stringa che accetta un valore esadecimale o un valore decimale nel formato MS\x, dove x è l'ID delle impostazioni locali. Ad esempio, è possibile immettere il valore inglese LocaleID come ms\0x0409 o ms\1033. Il provider SMS accetta LocaleID solo valori che usano il formato Microsoft. È possibile trovare un elenco di locale IDs in ID delle impostazioni locali assegnati da Microsoft.

Se sono necessarie le impostazioni locali per gli stati non statunitensi installazioni, è possibile ottenerlo dalla proprietà SMS_Identification Server WMI ClassLocaleID .

Machinename

Il MachineName qualificatore di contesto è un valore stringa che identifica il computer che esegue l'applicazione. È necessario specificare MachineName per l'applicazione perché viene usata per il controllo. Se non si specifica il nome del computer, viene utilizzato il valore Sconosciuto. È necessario specificare il valore MachineName quando si chiama uno dei metodi del messaggio di stato di generazione, ad esempio SMS_StatusMessage::RaiseRawStatusMsg, oppure la chiamata avrà esito negativo.

QueryQualifiers

Il QueryQualifiers qualificatore di contesto è un valore booleano usato per restituire i flag di bit SecurityVerbs quando si eseguono query su oggetti protetti, ad esempio SMS_Site o SMS_Package. Si noti che l'uso di QueryQualifiers quando si eseguono query su oggetti non protetti genera un errore. Per impostazione predefinita, i flag SecurityVerbs non vengono restituiti con la query. È necessario creare questo qualificatore e impostarne il valore su true se si desidera che i flag vengano restituiti. La mancata creazione QueryQualifiers equivale all'impostazione del relativo valore su false.

SessionHandle

Il SessionHandle qualificatore di contesto è un valore stringa restituito come parametro out del metodo GetSessionHandle. La stringa è un GUID univoco che identifica la copia dell'applicazione del file di controllo del sito da Configuration Manager. È consigliabile usare questo meccanismo per modificare il file di controllo del sito e ridurre le collisioni di dati con altre applicazioni che modificano contemporaneamente il file di controllo del sito. Se non si specifica un SessionHandle valore, l'applicazione modifica la copia globale del file di controllo del sito, che non ha alcuna protezione dalle applicazioni che sovrascriveno i dati l'uno dell'altro.