Proprietà personalizzate per i dispositivi

Articolo
04/04/2023

Si applica a: Configuration Manager (Current Branch)

Molti clienti hanno altri dati esterni a Configuration Manager, ma utili per la destinazione della distribuzione, la creazione di raccolte e la creazione di report. Questi dati sono in genere di natura non tecnica, non individuabili nel client e provengono da una singola origine esterna. Ad esempio, un sistema ITIL (IT Infrastructure Library) centrale o un database di asset, che ha alcuni degli attributi di dispositivo seguenti:

Posizione fisica
Priorità dell'organizzazione
Categoria
Centro di costo
Reparto

A partire dalla versione 2107, è possibile usare il servizio di amministrazione per impostare questi dati nei dispositivi. Il sito archivia il nome e il valore della proprietà nel database del sito come classe Device Custom Properties . È quindi possibile usare le proprietà personalizzate in Configuration Manager per la creazione di report o la creazione di raccolte.

A partire dalla versione 2111, è possibile creare e modificare queste proprietà personalizzate nella console di Configuration Manager. Questa nuova interfaccia utente semplifica la visualizzazione e la modifica di queste proprietà.

Nota

È possibile usare caratteri Unicode per i valori delle proprietà personalizzate, ma non per i nomi delle proprietà. Per altre informazioni, vedere Supporto di Unicode e ASCII in Configuration Manager.

Prerequisiti

L'account che effettua le chiamate API richiede le autorizzazioni seguenti per una raccolta che contiene il dispositivo di destinazione:

Per impostare le proprietà: Modifica risorsa
Per visualizzare le proprietà: Read Resource
Per rimuovere le proprietà: Elimina risorsa

Impostare le proprietà tramite l'interfaccia utente

Si applica alla versione 2111 o successiva

Nella console Configuration Manager passare all'area di lavoro Asset e conformità e selezionare il nodo Dispositivi.
Selezionare un dispositivo e quindi nella barra multifunzione selezionare Proprietà
Passare alla scheda Proprietà personalizzate .
Selezionare l'icona a stella d'oro per creare una nuova proprietà personalizzata. Specificare un nome per la proprietà e impostare un valore per il dispositivo. Selezionare OK per salvare le proprietà.

Scheda Proprietà personalizzate in un dispositivo con più valori.

Impostare le proprietà tramite l'API

Si applica alla versione 2107 o successiva

Per impostare le proprietà in un dispositivo, usare l'API SetExtensionData . Effettuare una chiamata POST all'URI https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.SetExtensionData con un corpo JSON. L'ID risorsa è un valore intero, ad esempio 16777345.

Questo esempio JSON imposta due coppie nome-valore per il tag di asset e la posizione del dispositivo:

{
  "ExtensionData": {
    "AssetTag":"0580255",
    "Location":"Dublin"
  }
}

Visualizzare le proprietà

Usare l'API GetExtensionData per visualizzare le proprietà personalizzate.

Per visualizzare le proprietà in un singolo dispositivo, effettuare una chiamata GET all'URI https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.GetExtensionData.

Per visualizzare le proprietà in tutti i dispositivi, effettuare una chiamata GET all'URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.GetExtensionData. Questa chiamata restituisce i valori delle proprietà dai dispositivi a cui si dispone dell'autorizzazione di lettura.

Rimuovere le proprietà

Per rimuovere i valori delle proprietà da tutti i dispositivi, usare l'API DeleteExtensionData senza un ID dispositivo. Includere un ID risorsa dispositivo per rimuovere solo le proprietà da un dispositivo specifico. Effettuare una chiamata POST all'URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.DeleteExtensionData.

Creare una raccolta

Per creare una raccolta con una regola di query basata sulle proprietà personalizzate, seguire questa procedura:

Nella console Configuration Manager creare una raccolta.
Nella pagina Regole di appartenenza selezionare Regola di query nell'elenco Aggiungi regola.
Nella Finestra Proprietà Regola di query specificare un nome per la query. Selezionare quindi Modifica istruzione query.
Nella Finestra Proprietà Istruzione query passare alla scheda Criteri. Selezionare quindi l'asterisco dorato (*) per aggiungere nuovi criteri.
Nella Finestra Proprietà Criterio selezionare i valori seguenti:
- Classe di attributo: Proprietà personalizzate del dispositivo
- Attributo: PropertyName
Selezionare un operatore e quindi specificare il nome della proprietà come Valore.

A questo punto, il Finestra Proprietà Criterion dovrebbe essere simile all'immagine seguente:

Selezionare OK per salvare il criterio.
Ripetere i passaggi per aggiungere un criterio per l'attributo PropertyValue .

A questo punto, l'istruzione query della raccolta Finestra Proprietà dovrebbe essere simile all'immagine seguente:
Selezionare OK per chiudere tutte le finestre delle proprietà. Completare quindi la procedura guidata per creare la raccolta.

Istruzione WQL di esempio

È anche possibile usare la query di esempio seguente. Nella finestra delle proprietà dell'istruzione di query selezionare Mostra linguaggio di query per incollare l'istruzione di query.

select SMS_R_SYSTEM.ResourceID,SMS_R_SYSTEM.ResourceType,SMS_R_SYSTEM.Name,SMS_R_SYSTEM.SMSUniqueIdentifier,SMS_R_SYSTEM.ResourceDomainORWorkgroup,SMS_R_SYSTEM.Client 
from SMS_R_System inner join SMS_G_System_ExtensionData on SMS_G_System_ExtensionData.ResourceId = SMS_R_System.ResourceId 
where SMS_G_System_ExtensionData.PropertyName = "AssetTag" and SMS_G_System_ExtensionData.PropertyValue = "0580255"

Nota

Per usare le istruzioni WQL delle proprietà personalizzate con gli aggiornamenti incrementali della raccolta, usare Configuration Manager versione 2107 con l'aggiornamento cumulativo o versione successiva.