Qualificatori di contesto di Configuration Manager

Gli oggetti 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 di contesto, ad esempio il nome dell'applicazione. È possibile usare i qualificatori di contesto quando ci si connette al provider SMS e con singoli oggetti provider SMS.

Codice gestito

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

VBScript

Quando si usa VBScript, si usa il set di interfacce SWBemNamedValue per specificare i qualificatori di contesto come una raccolta di oggetti valore denominati. Per altre informazioni, vedi Come aggiungere un qualificatore di contesto di Configuration Manager tramite WMI.

Qualificatori contesto

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

Qualificatore contesto	Descrizione
ApplicationName	Identifica l'applicazione che ha effettuato la chiamata.
ContextHandle	Identifica la posizione in cui 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 usare.
MachineName	Identifica il computer che esegue l'applicazione.
QueryQualifiers	Restituisce i contrassegni di bit SecurityVerbs quando si eseguono query su oggetti protetti.
SessionHandle	Identifica la copia dell'applicazione del file di controllo sito in 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 utilizzata per il controllo. Se non si specifica il nome dell'applicazione, verrà utilizzato il valore Sconosciuto. È necessario fornire il ApplicationName valore quando si chiama uno dei metodi del messaggio di stato di sollevamento, ad esempio SMS_StatusMessage::RaiseErrorStatusMsg, altrimenti la chiamata avrà esito negativo.

ContextHandle

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

1. Create il set di valori SWBemNamedValue .

2. Aggiungi i qualificatori all'oggetto contesto. Per altre informazioni, vedi Come aggiungere un qualificatore di contesto di Configuration Manager tramite WMI.

3. Chiama il metodo GetContextHandle per memorizzare nella cache i qualificatori nel server. Il provider SMS memorizza nella cache l'oggetto contesto passato come parametro di ExecMethod quando si chiama GetContextHandle.

4. Rimuovere tutti i qualificatori dall'oggetto contesto.

5. Aggiungi il qualificatore e il valore all'oggetto ContextHandle contesto.

6. Passare l'oggetto contesto in tutte le chiamate a IWbemServices.

   È necessario chiamare il metodo ClearContextHandle per rimuovere i qualificatori memorizzati nella cache prima di uscire dall'applicazione. È possibile creare il numero di ContextHandle valori desiderato, ognuno dei quali fornisce informazioni diverse 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 contesto.

InstanceCount

Il InstanceCount qualificatore di contesto è un valore intero usato per limitare il numero di istanze restituite dai metodi ExecQuery e CreateInstanceEnum . InstanceCount È impostato uguale al numero massimo di istanze che si desidera venga restituito dalla query o dall'enumeratore. Ad esempio, l'impostazione InstanceCount su 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. Si usa questo qualificatore per limitare i risultati di una query di risorsa ai membri della raccolta denominata. Una query di risorsa è una query che include classi derivate da SMS_Resource o SMS_Group.

L'utente deve disporre delle autorizzazioni per le risorse di lettura dell'istanza per la raccolta a cui appartiene la risorsa. È necessario utilizzare 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 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. Puoi trovare un elenco degli locale IDsID delle impostazioni locali assegnati da Microsoft.

Se sono necessarie le impostazioni locali per i paesi 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 utilizzata per il controllo. Se non si specifica il nome del computer, verrà utilizzato il valore Sconosciuto. È necessario specificare il valore MachineName quando si chiama uno dei metodi del messaggio di stato di sollevamento, ad esempio SMS_StatusMessage::RaiseRawStatusMsg, altrimenti la chiamata avrà esito negativo.

QueryQualifiers

Il QueryQualifiers qualificatore di contesto è un valore booleano che viene utilizzato per restituire i contrassegni di bit SecurityVerbs quando si eseguono query su oggetti protetti, come SMS_Site o SMS_Package. Si noti che l'uso QueryQualifiers quando si esegue una query su oggetti non protetti genera un errore. Per impostazione predefinita, i flag SecurityVerbs non vengono restituiti con la query. Devi creare questo qualificatore e impostarne il valore se true vuoi che vengano restituiti i flag. Non creare QueryQualifiers equivale a impostarne il 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 in Configuration Manager. È consigliabile usare questo meccanismo per modificare il file di controllo del sito e ridurre i conflitti di dati con altre applicazioni che stanno modificando 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 è protetta dalle applicazioni che sovrascrivono i dati dell'altro.

Nota

Se si utilizza il provider SMS gestito, la gestione della sessione dei file di controllo del sito viene gestita automaticamente.

Vedere anche

Come aggiungere un qualificatore di contesto di Configuration Manager tramite codice gestitoCome aggiungere un qualificatore di contesto di Configuration Manager using WMINozioni fondamentali sul provider SMS