A.3. Analyse du résultat de la commande

A.3.1. Sous-commandes ayant pour résultat une tâche unique
A.3.2. Sous-commandes résultant en plusieurs tâches
A.3.3. user-search
A.3.4. user-show
A.3.5. user-desktops
A.3.6. group-list
A.3.7. group-show
A.3.8. token-search
A.3.9. token-show
A.3.10. token-desktops
A.3.11. pool-list
A.3.12. pool-show
A.3.13. pool-users
A.3.14. pool-desktops
A.3.15. pool-templates
A.3.16. desktop-search
A.3.17. template-revisions
A.3.18. provider-list
A.3.19. provider-list-hosts
A.3.20. provider-list-storage
A.3.21. provider-list-templates
A.3.22. provider-list-unmanaged
A.3.23. provider-list-networks
A.3.24. provider-show
A.3.25. provider-storage-orphans
A.3.26. directory-list
A.3.27. admin-list
A.3.28. admin-show
A.3.29. role-list
A.3.30. job-list
A.3.31. job-show

Certaines sous-commandes vda prennent en charge une option analysable qui simplifie l'analyse des résultats en les présentant sous forme de liste de lignes de champs séparés par deux points (« : »).

La syntaxe de l'option est la suivante :

-x, --parseable Display output suitable for programmatic parsing.

Les sections suivantes décrivent le format de sortie des sous-commandes qui prennent en charge cette option.

A.3.1. Sous-commandes ayant pour résultat une tâche unique

Les sous-commandes vda suivantes ont pour résultat une tâche unique :

  • pool-hv-import : importe les bureaux Microsoft Hyper-V dans le pool.

  • pool-vb-import : importe les bureaux Oracle VM VirtualBox dans le pool.

  • pool-vb-import-unmanaged : importe les bureaux Oracle VM VirtualBox non gérés dans le pool.

  • desktop-export : exporte un bureau.

  • revision-create : crée une révision.

  • revision-export : exporte une révision.

  • revision-sysprep : prépare une révision.

  • template-create : copie une révision dans un nouveau modèle.

  • template-desktop : copie le modèle dans un nouveau bureau.

  • template-export : exporte un modèle.

  • template-revert : rétablit la version la plus récente d'un modèle.

  • provider-migrate-host : fait migrer les bureaux à partir d'un hôte.

  • provider-replace-storage : remplace un stockage.

  • provider-suspend-storage : met un stockage en pause.

Sortie analysable : une ligne contenant la valeur suivante.

Valeur

Format de données

ID de la tâche

entier

A.3.2. Sous-commandes résultant en plusieurs tâches

Les sous-commandes vda suivantes ont plusieurs tâches pour résultat :

  • pool-delete : supprime les pools et leurs bureaux.

  • pool-reset : rétablit le clonage du pool.

  • desktop-delete : supprime des bureaux.

  • desktop-duplicate : copie des bureaux.

  • desktop-restart : redémarre des bureaux.

  • desktop-start : démarre des bureaux.

  • desktop-stop : arrête des bureaux.

  • desktop-suspend : met des bureaux en pause.

  • desktop-template : convertit les bureaux en modèles.

  • revision-clone : clone des bureaux à partir de révisions.

  • revision-delete : supprime des révisions.

  • revision-desktop : copie des révisions dans des bureaux.

  • template-delete : supprime des modèles.

  • template-restart : redémarre des modèles.

  • template-start : démarre des modèles.

  • template-stop : arrête des modèles.

  • template-suspend : met des modèles en pause.

  • provider-storage-orphan-delete : supprime les disques orphelins.

Sortie analysable : liste de lignes contenant les valeurs suivantes.

Valeur

Format de données

ID de la tâche

entier

A.3.3. user-search

Recherche des utilisateurs ou des groupes répondant aux critères de recherche spécifiés dans le répertoire des utilisateurs.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom de l'utilisateur ou du groupe

chaîne

Type d'objet

User | Group

DN de l'utilisateur ou du groupe

chaîne

A.3.4. user-show

Affiche les bureaux disponibles pour l'utilisateur.

Sortie analysable pour un utilisateur : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom de pool

chaîne

Nom du bureau

chaîne

ID de bureau

entier

Type d'assignation

User | Token jeton | Group nom_du_groupe | Custom Group nom_du_groupe

Sortie analysable pour un groupe : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom de pool

chaîne

A.3.5. user-desktops

Affiche les bureaux assignés à l'utilisateur.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom du bureau

chaîne

ID de bureau

entier

Nom de pool

chaîne

Type d'assignation

flexible | personal

Bureau par défaut

true | false

A.3.6. group-list

Répertorie les groupes personnalisés.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom du groupe personnalisé

chaîne

A.3.7. group-show

Affiche les pools assignés au groupe personnalisé.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom de pool

chaîne

A.3.8. token-search

Recherche les jetons répondant aux critères spécifiés.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Jeton

chaîne

Nom de l'utilisateur associé

chaîne

DN de l'utilisateur associé

chaîne

A.3.9. token-show

Affiche les bureaux disponibles pour le jeton.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom de pool

chaîne

Nom du bureau

chaîne

ID de bureau

entier

Type d'assignation

User | Token | Group nom_du_groupe | Custom Group nom_du_groupe

A.3.10. token-desktops

Affiche les bureaux assignés au jeton.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom du bureau

chaîne

ID de bureau

entier

Nom de pool

chaîne

Type d'assignation

flexible | personal

Bureau par défaut

true | false

A.3.11. pool-list

Répertorie tous les pools.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom de pool

chaîne

Type d'assignation de bureau

Personal | Flexible

Nombre de bureaux

entier

Nom du fournisseur de bureau

chaîne

Nom du répertoire utilisateur

chaîne

A.3.12. pool-show

Affiche des informations détaillées sur le pool.

Sortie analysable pour les pools non PC : une ligne contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Statut de l'assignation

Enabled | Disabled

Type d'assignation de bureau

Personal | Flexible

Nom du fournisseur de bureau

chaîne

État du clonage

Enabled | Disabled

Nombre de tâches de clonage

entier

Modèle

None | string

Nombre de bureaux disponibles

entier

Nombre de bureaux assignés

entier

Nombre total de bureaux

entier

Pool d'invités

Enabled | Disabled

Sortie analysable pour les pools de PC : une ligne contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Statut de l'assignation

Enabled | Disabled

Type d'assignation de bureau

Personal | Flexible

Nom du fournisseur de bureau

chaîne

Nombre de bureaux disponibles

entier

Nombre de bureaux assignés

entier

Nombre total de bureaux

entier

Pool d'invités

Enabled | Disabled

A.3.13. pool-users

Liste de tous les utilisateurs du pool.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom de l'utilisateur ou du groupe

chaîne

Type d'objet

User | Group | Token | Custom Group

DN de l'utilisateur ou du groupe

chaîne

A.3.14. pool-desktops

Répertorie tous les bureaux du pool.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom du bureau

chaîne

ID de bureau

long

État de la machine

Running | Starting | Paused | Powered Off | Suspended | Stuck | Aborted | Unknown

État du bureau

Used | Idle | Unresponsive | Reserved | Available

DN de l'utilisateur assigné

chaîne

A.3.15. pool-templates

Répertorie tous les modèles du pool.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom du modèle

chaîne

ID de modèle

long

État de la machine

Running | Starting | Paused | Powered Off | Suspended | Stuck | Aborted | Unknown

Révision principale

chaîne

Bureaux clonés

chaîne

A.3.16. desktop-search

Recherche un ou des bureaux.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

ID de bureau

long

Nom de pool

chaîne

Nom du bureau

chaîne

État de la machine

Running | Starting | Paused | Powered Off | Suspended | Stuck | Aborted | Unknown

État du bureau

Available | Used | Idle | Unresponsive | Reserved

DN de l'utilisateur assigné

chaîne

A.3.17. template-revisions

Répertorie les révisions du modèle.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom de révision

chaîne

ID de révision

long

Date de création

timestamp

Révision principale

yes | no

Bureaux clonés

chaîne

A.3.18. provider-list

Répertorie tous les fournisseurs de bureaux.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom du fournisseur de bureau

chaîne

Type de fournisseur

Oracle VM VirtualBox | VMware vCenter | Microsoft Hyper-V | Microsoft Remote Desktop | PC | Kiosk

Statut

OK | Unresponsive | Major Issues | Critical

A.3.19. provider-list-hosts

Répertorie tous les hôtes des fournisseurs de bureau Oracle VDI, Microsoft Hyper-V ou Microsoft Remote Desktop.

Sortie analysable pour les fournisseurs Oracle VDI et Microsoft Hyper-V : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom d'hôte

chaîne

Statut

Enabled | Disabled | Unresponsive | Maintenance | Preparing Maintenance | Failed Maintenance

Activé

Enabled | Disabled

Utilisation CPU

xx% (x.x GHz|MHz)

Utilisation de la mémoire

xx% (x.x Go|Mo)

Nombre de bureaux

entier

Sortie analysable pour les fournisseurs de bureau à distance Microsoft : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom d'hôte

chaîne

Statut

OK | Unresponsive

Utilisation CPU

xx% (x.x GHz|MHz)

Utilisation de la mémoire

xx% (x.x Go|Mo)

Nombre de sessions actives

entier

Nombre de sessions déconnectées

entier

A.3.20. provider-list-storage

Répertorie tous les serveurs de stockage correspondant au fournisseur de bureaux.

Sortie analysable pour les fournisseurs Oracle VDI et Microsoft Hyper-V : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom de stockage

chaîne

Statut

Enabled | Disabled | Unresponsive | Maintenance | Preparing Maintenance | Failed Maintenance

Pool ZFS

chaîne

Capacité

xxx.x Go

Utilisation

xx.x Go

Nombre de bureaux

entier

Sortie analysable pour les fournisseurs VMware vCenter : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom de stockage

chaîne

ID de stockage

chaîne

Pool ZFS

chaîne

Capacité

xxx.x Go

Utilisation

xx.x Go

Nombre de bureaux

entier

A.3.21. provider-list-templates

Répertorie les modèles correspondant au fournisseur de bureaux.

Sortie analysable pour les fournisseurs Oracle VDI et Microsoft Hyper-V : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom du modèle

chaîne

ID de modèle

long

Nom du répertoire des utilisateurs

chaîne

Sortie analysable pour les fournisseurs VMware vCenter : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom du modèle

chaîne

ID de modèle

chaîne

Chemin

chaîne

A.3.22. provider-list-unmanaged

Répertorie les bureaux de la plate-forme de virtualisation qui ne sont gérés par aucun fournisseur de bureau.

Sortie analysable pour les fournisseurs Oracle VDI et Microsoft Hyper-V : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom d'hôte

chaîne

Nom du bureau

chaîne

ID de bureau

long

Sortie analysable pour les fournisseurs VMware vCenter : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom du bureau

chaîne

ID de bureau

chaîne

Chemin

chaîne

A.3.23. provider-list-networks

Répertorie tous les réseaux correspondant au fournisseur de bureau.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Étiquette de sous-réseau

Chaîne

Adresse de sous-réseau

Chaîne

Disponibilité

All Hosts | Not on: liste_des_hôtes_séparés_par_une_virgule

A.3.24. provider-show

Affiche des informations détaillées sur le fournisseur de bureau.

Sortie analysable pour les fournisseurs Oracle VDI et Microsoft Hyper-V : une ligne contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Statut

OK | Major Issues | Critical

Noms des pools

chaînes séparées par des virgules

Nombre total de bureaux

entier

Nombre total de bureaux utilisés

entier

Utilisation CPU de tous les hôtes

xx%

Mémoire totale de tous les hôtes

xx.xx Go|Mo

Utilisation de la mémoire de tous les hôtes

xx%

Nombre de serveurs de stockage

entier

Capacité totale des serveurs de stockage

xxx.x Go

Utilisation des serveurs de stockage

xx%

Nombre de réseaux

entier

Disponibilité du réseau

All Hosts | Not on some hosts

Commentaire

chaîne

Sortie analysable pour les fournisseurs VMware vCenter : une ligne contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Statut

OK | Unresponsive

Noms des pools

chaînes séparées par des virgules

Nombre total de bureaux

entier

Nombre total de bureaux utilisés

entier

Serveur

chaîne

Centres de données

chaînes séparées par des virgules

Nombre de serveurs de stockage

entier

Capacité totale des serveurs de stockage

xxx.x Go

Utilisation des serveurs de stockage

xx%

Commentaire

chaîne

Suivi d'une liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom du cluster

chaîne

CPU du cluster utilisé

xx%(xx.xx MHz|GHz)

Mémoire totale du cluster

xx.xx Go|Mo

Mémoire utilisée par le cluster

xx% (xx.xx Mo|Go)

Sortie analysable pour les fournisseurs de bureau à distance hors ferme : une ligne contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Statut

OK | Major Issues | Critical

Noms des pools

chaînes séparées par des virgules

Nombre de sessions actives

entier

Nombre de sessions déconnectées

entier

Ferme hôte

false

Utilisation CPU de tous les hôtes

xx%

Mémoire totale de tous les hôtes

xx.xx Go|Mo

Utilisation de la mémoire de tous les hôtes

xx%

Commentaire

chaîne

Sortie analysable pour les fournisseurs de bureau à distance de ferme : une ligne contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Statut

-

Noms des pools

chaînes séparées par des virgules

Ferme hôte

true

Commentaire

chaîne

Sortie analysable pour les fournisseurs génériques : une ligne contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Noms des pools

chaînes séparées par des virgules

Nombre total de bureaux

entier

Nombre total de bureaux utilisés

entier

Commentaire

chaîne

Sortie analysable pour les fournisseurs de kiosques : une ligne contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Noms des pools

chaînes séparées par des virgules

Type de session

Sun Java Desktop System 3 | Common Desktop Environment (Obsolète) | Sun Ray Connector for Windows OS | VMware View Manager Session | Xterm Terminal Session

Commentaire

chaîne

A.3.25. provider-storage-orphans

Répertorie les disques orphelins du stockage.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Volume ZFS

pool_zfs/id_volume/

Taille

xxx.x Go

Taille utilisée

xxx.x Go

Disques clonés

long

A.3.26. directory-list

Répertorie tous les répertoires utilisateur.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom

chaîne

Statut

OK | Unresponsive

Domaine AD ou DN de base

chaîne

A.3.27. admin-list

Répertorie tous les administrateurs et leurs rôles.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom d'utilisateur

chaîne

Rôles

chaîne séparée par des virgules

A.3.28. admin-show

Affiche les détails de l'administrateur.

Sortie analysable : une ligne contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Description de l'utilisateur

chaîne

Suivi d'une liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom du rôle

chaîne

Description du rôle

chaîne

A.3.29. role-list

Répertorie tous les rôles.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Nom du rôle

chaîne

Description du rôle

chaîne

A.3.30. job-list

Répertorie les tâches existantes.

Sortie analysable : liste de lignes contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Titre

Titre de la tâche, par exemple, Cloning Desktop nom_du_bureau | Recycling Desktop nom_du_bureau | Starting Desktop nom_du_bureau | Powering Off Desktop nom_du_bureau | Shutting Down Desktop nom_du_bureau | Restarting Desktop nom_du_bureau | Deleting Pool nom_du_bureau.

Cible de la tâche

chaîne

Statut de la tâche

Queued | Running | Completed | Failed | Cancelling | Cancelled | Unknown

ID de la tâche

entier

Annulable

'C' si la tâche peut être annulée

A.3.31. job-show

Affiche les détails de la tâche.

Sortie analysable : une ligne contenant les valeurs suivantes séparées par deux points (« : »).

Valeur

Format de données

Titre

Titre de la tâche, par exemple, Cloning Desktop nom_du_bureau | Recycling Desktop nom_du_bureau | Starting Desktop nom_du_bureau | Powering Off Desktop nom_du_bureau | Shutting Down Desktop nom_du_bureau | Restarting Desktop nom_du_bureau | Deleting Pool nom_du_bureau

Cible de la tâche

chaîne

Statut de la tâche

Queued | Running | Completed | Failed | Cancelling | Cancelled | Unknown

Heure de début

hh:mm:ss

Heure de fin

hh:mm:ss

Détails de la tâche

chaîne

Annulable

true | false