Proprietà personalizzate per i dispositivi

Si applica a: Configuration Manager (Current Branch)

Molti clienti dispongono di altri dati esterni a Configuration Manager, ma utili per la distribuzione di destinazione, la creazione di raccolte e la creazione di report. Questi dati sono in genere di natura non tecnica, non individuabili sul client e provengono da un'unica origine esterna. Ad esempio, un sistema ITIL (IT Infrastructure Library) centrale o un database di risorse, con alcuni degli attributi del dispositivo seguenti:

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

A partire dalla versione 2107, puoi usare il servizio di amministrazione per impostare questi dati nei dispositivi. Il sito archivia il nome della proprietà e il relativo valore nel database del sito come classe Proprietà personalizzate dispositivo . È quindi possibile usare le proprietà personalizzate in Configuration Manager per creare report o raccolte.

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

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à: Leggi risorsa
• Per rimuovere le proprietà: Elimina risorsa

Impostare le proprietà tramite l'interfaccia utente

Si applica alla versione 2111 o successiva

1. Nella console di Configuration Manager passare all'area di lavoro Asset e conformità e selezionare il nodo Dispositivi.

2. Selezionare un dispositivo e quindi nella barra multifunzione selezionare Proprietà

3. Passare alla scheda Proprietà personalizzate .

4. Selezionare l'icona della stella dorata per creare una nuova proprietà personalizzata. Specificare un nome per la proprietà e impostare un valore per questo dispositivo. Selezionare OK per salvare le proprietà.

Impostare le proprietà tramite API

Si applica alla versione 2107 o successiva

Per impostare le proprietà in un dispositivo, usare l'API SetExtensionData . Effettua 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 e la posizione dell'asset del dispositivo:

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

Visualizza proprietà

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

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

Per visualizzare le proprietà su 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 per i quali si dispone dell'autorizzazione di lettura.

Rimuovere 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 le proprietà solo da un dispositivo specifico. Effettuare una chiamata POST all'URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.DeleteExtensionData.

Creare una raccolta

Usare la procedura seguente per creare una raccolta con una regola di query basata sulle proprietà personalizzate:

1. Nella console di Configuration Manager Crea una raccolta.

2. Nell'elenco Aggiungi regola della pagina Regole di appartenenza selezionare Regola query.

3. Nella Finestra Proprietà regola query specificare un nome per la query. Quindi selezionare Edit Query Statement.

4. Nella Finestra Proprietà istruzione query passare alla scheda Criteri. Quindi selezionare l'asterisco dorato (*) per aggiungere nuovi criteri.

5. Nella Finestra Proprietà criterio, selezionare i valori seguenti:

   • Classe attributo: Proprietà personalizzate dispositivo
   • Attributo: PropertyName

6. Selezionare un operatore e quindi specificare il nome della proprietà come valore.

   A questo punto, la finestra Finestra Proprietà criterio dovrebbe essere simile all'immagine seguente:

   

   Selezionare OK per salvare il criterio.

7. Ripetere i passaggi per aggiungere un criterio per l'attributo PropertyValue .

   A questo punto, la Finestra Proprietà istruzione query della raccolta dovrebbe essere simile all'immagine seguente:

   

8. Selezionare OK per chiudere tutte le finestre delle proprietà. Completare quindi la procedura guidata per creare la raccolta.

Esempio di istruzione WQL

È anche possibile usare la seguente query di esempio. Nella finestra delle proprietà dell'istruzione di query selezionare Mostra lingua 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"

Passaggi successivi

Come utilizzare il servizio di amministrazione

Creare una raccolta

Come gestire i client