Search <book_title>...

Guide de l'administrateur NetBackup™ for VMware

Last Published: 2023-01-17

Product(s): NetBackup (10.1.1)

Référence de champ du générateur de requêtes

Vous pouvez utiliser le générateur de requêtes pour entrer des règles de sélection automatique des machines virtuelles VMware pour la sauvegarde.

Remarque :

Vous pouvez configurer et gérer des politiques VMware à l'aide de l'interface utilisateur Web NetBackup. Dans l'interface utilisateur Web, le mode avancé du générateur de requêtes utilise des mots-clés et des opérateurs OData. Sinon, le générateur de requêtes fonctionne de la même manière que dans la console d'administration NetBackup.

Tableau : Options déroulantes du générateur de requêtes : Joindre, Champ, Opérateur, Valeurs décrit les champs et les options déroulants permettant de créer des règles dans le générateur de requêtes.

Tableau : Options déroulantes du générateur de requêtes : Joindre, Champ, Opérateur, Valeurs

Listes déroulantes du générateur de requêtes	Description
Joindre	Sélectionne un connecteur pour se connecter à des règles. Pour la première règle, les choix disponibles sont vierge (aucune) ou NON. Une fois qu'une règle a été ajoutée, les connecteurs disponibles sont AND, AND NOT, OR et OR NOT.
Champ	Sélectionne un paramètre sur lequel fonder la règle. Sélectionnez-en un dans la liste (faites défiler pour afficher des paramètres supplémentaires). Vous pouvez saisir le premier caractère pour accélérer la sélection. Par exemple, en entrant "d", la liste affiche la première entrée commençant par "d". Si vous saisissez "d" de nouveau, la liste affiche la prochaine entrée commençant par "d". L'entrée sélectionnée est automatiquement complétée. Se reporter à Tableau : Mots-clés du menu déroulant Champ .
Opérateur	Sélectionne un opérateur. Les opérateurs disponibles dépendent du paramètre sélectionné dans Champ. Se reporter à Tableau : Opérateurs dans la liste déroulante Opérateur.
Valeur(s)	Spécifie une valeur pour le paramètre Champ. Le champ Valeur permet la saisie manuelle. Il peut également s'agir d'une liste déroulante, selon les sélections qui sont faites dans les autres champs. Pour la saisie manuelle, vous pouvez spécifier plusieurs valeurs séparées par une virgule. Se reporter à Tableau : Caractères acceptés dans le champ Valeur(s).
	Permet de rechercher des valeurs spécifiques, selon les sélections qui sont faites dans les autres champs déroulants.
	Ajoute les sélections des listes déroulantes actuelles au volet Requête en tant que nouvelle règle.
	Masque le contenu des champs déroulants.

Champ (mots-clés)

Tableau : Mots-clés du menu déroulant Champ décrit les mots-clés disponibles dans Champ déroulant. Le tableau indique également si les valeurs pour chaque mot-clé (dans le champ Valeurs) sont sensibles à la casse.

Remarque :

Utilisez des mots-clés de Champ uniquement lorsque vous générez des requêtes à l'aide du mode avancé de l'interface utilisateur Web NetBackup sous Générateur de requêtes ou des API NetBackup.

Notez que l'inclusion ou l'exclusion des machines virtuelles n'est pas déterminée par le seul mot-clé Champ, mais dépend de la règle que vous générez : une combinaison de Joindre, Champ, Opérateur et Valeurs.

Tableau : Mots-clés du menu déroulant Champ

Mot-clé de champ	Mot-clé de champ OData	Type de données	Description
Annotation	annotation	Chaîne alphanumérique	Texte qui est ajouté aux annotations de machine virtuelle dans vSphere Client. Les valeurs sont sensibles à la casse.
AssetGroup	assetGroup		NOUVEAU
Cluster	cluster	Chaîne alphanumérique	Nom du cluster (un groupe de serveurs ESX) dans lequel la machine virtuelle est configurée. Les valeurs ne sont pas sensibles à la casse. Remarque : Une machine virtuelle peut être assignée à un serveur ESX qui ne fait pas partie d'un cluster. Notez également que dans VMware, un nom de cluster se doit d'être unique seulement au sein d'un chemin de data center.
Datacenter	datacenter	Chaîne alphanumérique	Nom du data center de VMware. Les valeurs ne sont pas sensibles à la casse.
DatacenterPath	DatacenterPath	Chaîne alphanumérique	Structure de dossier qui définit le chemin d'accès à un data center. Utilisez cette option si le nom du data center que vous voulez filtrer n'est pas unique dans votre environnement. Les valeurs sont sensibles à la casse.
Datastore	datastoreName	Chaîne alphanumérique	Nom du datastore. Les valeurs sont sensibles à la casse. Remarque : Plusieurs serveurs ESX peuvent partager l'accès au même datastore. En outre, un nom de stockage de données peut être dupliqué entre plusieurs serveurs ESX. Utilisez DatacenterPath ou ESXserver pour identifier précisément le data center.
DatastoreCluster	datastoreCluster	Chaîne alphanumérique	Nom du cluster de stockage de données qui contient les stockages de données. Les valeurs ne sont pas sensibles à la casse.
DatastoreFolder	datastoreFolder	Chaîne alphanumérique	Nom du dossier qui contient les stockages de données. Les valeurs ne sont pas sensibles à la casse.
DatastoreNFSHost	datastoreNfsHost	Chaîne alphanumérique	Nom de l'hôte du NFS du stockage de données. Les valeurs ne sont pas sensibles à la casse.
DatastoreNFSPath	datastoreNfsPath	Chaîne alphanumérique	Structure de dossier qui définit le chemin d'accès à un stockage de données NFS. Utilisez cette option si le nom d'hôte NFS du stockage de données que vous voulez filtrer n'est pas le seul dans votre environnement. Les valeurs ne sont pas sensibles à la casse.
DatastoreType	datastoreType	Chaîne alphanumérique	Type du stockage de données. Les valeurs sont NFS, NFS41, VMFS, vsan et VVOL. Les valeurs ne sont pas sensibles à la casse.
Displayname	displayName	Chaîne alphanumérique	Nom affiché de la machine virtuelle. Les valeurs sont sensibles à la casse.
ESXserver	host	Chaîne alphanumérique	Nom du serveur ESX. Les valeurs ne sont pas sensibles à la casse. Le nom d'hôte ESX doit correspondre au nom défini dans le serveur vCenter.
HostFolder	hostFolder	Chaîne alphanumérique	Chemin d'accès du dossier entre le niveau de data center et un cluster, les hôtes ESX ou un sous-dossier. Si le dossier ne contient aucun cluster ESX, cliquez sur le bouton de navigation. Remarque : le nom du cluster ESX apparaît dans la boîte de dialogue Sélectionner dans la liste. Les valeurs ne sont pas sensibles à la casse. Se reporter à Règles de requête pour des dossiers de centre de données (dossier hôte).
InstanceUUID	instanceUuid	Chaîne alphanumérique	UUID d'instance de la machine virtuelle. Exemple de requête: InstanceUUID Equal "501b13c3-52de-9a06-cd9a-ecb25aa975d1" Les valeurs ne sont pas sensibles à la casse.
Network	network	Chaîne alphanumérique	Nom du commutateur réseau (sur un serveur ESX) ou du commutateur distribué. Les valeurs ne sont pas sensibles à la casse.
NetworkFolder	networkFolder	Chaîne alphanumérique	Nom du dossier qui contient le réseau. Les valeurs ne sont pas sensibles à la casse.
Powerstate	powerState	Lettre alphabétique	État d'alimentation de la machine virtuelle. Les valeurs sont Sous tension, Hors tension, Interrompu.
Resourcepool	resourcePool	Chaîne alphanumérique	Nom du pool de ressources. Nom du pool de ressources. (un pool de ressources est semblable à une vApp). Les valeurs sont sensibles à la casse. Si un pool de ressources contient d'autres pools de ressources (sous-pools), le choix de l'opérateur détermine si les machines virtuelles comprises dans les sous-pools sont incluses. Se reporter à Règles de requête pour les pools de ressources.
Tag	tagName	Chaîne alphanumérique	Nom de l'étiquette. Les valeurs sont sensibles à la casse. Quand NetBackup utilise des étiquettes pour sélectionner des machines virtuelles, la sélection est basée uniquement sur des noms d'étiquette. La sélection est indépendante de la catégorie. Se reporter à Règles de requête pour les étiquettes.
Template	template	Valeur booléenne	VRAI si la machine virtuelle est un modèle de machine virtuelle.
vApp	vApp	Chaîne alphanumérique	Nom de la vApp. Les valeurs sont sensibles à la casse. Une vApp est une collection de machines virtuelles. Les vApps peuvent également contenir des pools de ressources et d'autres vApps. Les vApps sont des composants de serveurs ESX autonomes ou de clusters. Comme vSphere Client, NetBackup se réfère seulement au niveau supérieur d'une vApp qui contient des sous-vApps. Pour la règle suivante : vApp Equal "vapp1" si vapp1 possède une sous-vApp nommée "vapp2", toutes les machines virtuelles dans vapp1 ou vapp2 sont incluses. Vous ne pouvez pas établir de règle qui se réfère spécifiquement à vapp2.
vCDCatalog	vcdCatalog	Chaîne alphanumérique	Nom du catalogue de vCloud Director. Les valeurs ne sont pas sensibles à la casse.
vCDIsExpired	vcdIsExpired	Lettre alphabétique	Expiré si vApp vCloud Director ou le modèle de vApp a expiré. Les valeurs possibles sont Expiré, Non expiré et Inconnu. Inconnu indique qu'une erreur s'est produite entre vCloud Director et l'environnement vSphere. Les exemples sont des erreurs dans le provisionnement ou dans une opération de suppression.
vCDIsvAppTemplate	vcdIsvAppTemplate	Valeur booléenne	VRAI si la vApp de vCloud Director est un modèle.
vCDOrg	vcdOrg	Chaîne alphanumérique	Nom de la société de vCloud Director. Les valeurs ne sont pas sensibles à la casse.
vCDOrgvDC	vcdOrgvDC	Chaîne alphanumérique	Nom de la société de data center virtuel dans vCloud Director. Les valeurs ne sont pas sensibles à la casse.
vCDServer	vcdServer	Chaîne alphanumérique	Nom du serveur vCloud Director. Les valeurs ne sont pas sensibles à la casse.
vCDvApp	vcdVapp	Chaîne alphanumérique	Nom de la vApp de vCloud Director. Les valeurs ne sont pas sensibles à la casse.
vCenter	vCenter	Chaîne alphanumérique	Nom du serveur vCenter. Les valeurs ne sont pas sensibles à la casse. Le nom vCenter spécifié dans le générateur de requêtes doit correspondre au nom saisi dans la console d'administration pour les informations d'authentification de NetBackup. (Gestion des médias et des périphériques > Informations d'authentification > Serveurs de machines virtuelles.) Notez qu'un nom de domaine complet est recommandé.
vCenterVersion	vCenterVersion	Chaîne alphanumérique	Version du serveur vCenter. Par exemple : 5.1.0, 5.5.0, 6.0.0 Les valeurs possibles de ce champ sont automatiquement mises à jour et renseignées en fonction de l'environnement. Seules les versions des serveurs vCenter enregistrées avec NetBackup s'affichent.
VMDNSName	dnsName	Chaîne alphanumérique	Nom DNS de machine virtuelle dans vSphere Client. Les valeurs ne sont pas sensibles à la casse.
VMFolder	vmFolder	Chaîne alphanumérique	Nom du dossier de machines virtuelles (au sein d'un datacenter), incluant le chemin d'accès au dossier contenant les machines virtuelles. Les valeurs ne sont pas sensibles à la casse. Prenons l'exemple des dossiers de machines virtuelles suivants contenant un total de 65 machines virtuelles : vm\VM_backup_prod1 (contains 5 VMs) vm\VM_backup_prod1\cluster1 (contains 10 VMs) vm\VM_backup_prod2 (contains 50 VMs) Pour inclure les machines virtuelles de`vm\VM_backup_prod1`, mais pas celles de `cluster1` ou de tout autre dossier : VMFolder Equal "vm\VM_backup_prod1" Pour inclure les machines virtuelles de `vm\VM_backup_prod1` et de son sous-dossier `cluster1` : VMFolder Equal "vm\VM_backup_prod1" OR VMFolder StartsWith "vm\VM_backup_prod1\\" Remarque : La première barre oblique inverse est un caractère d'échappement qui permet à la barre oblique inverse suivante d'être interprétée comme un caractère alphabétique. Pour inclure les 65 machines virtuelles : VMFolder StartsWith "vm\VM_backup_prod" Remarque : Aucune machine virtuelle se trouvant dans un chemin qui commence par `vm\VM_backup_prod` n'est incluse.
VMGuestOS	vmGuestOs	Chaîne alphanumérique	Type d'OS invité de la machine virtuelle qui est enregistré dans vSphere Client. Les valeurs sont sensibles à la casse.
VMHasIDE	vmHasIde	Valeur booléenne	VRAI si la machine virtuelle a des lecteurs IDE.
VMhasIndD	vmHasIndD		NOUVEAU
VMHasMDS	vmHasMds	Valeur booléenne	VRAI si la machine virtuelle a plusieurs datastores. Vous pouvez utiliser ce mot-clé pour sélectionner n'importe quelle machine virtuelle configurée pour utiliser plus d'un datastore.
VMHasNVME	vmHasNvme	Valeur booléenne	VRAI si la machine virtuelle possède des lecteurs NVMe.
VMHasRDM	vmHasRdm	Valeur booléenne	VRAI si la machine virtuelle utilise RDM (Raw Device Mapping).
VMHasRDMO	vmHasRdmo		NOUVEAU
VMHasSATA	vmHasSata	Valeur booléenne	VRAI si la machine virtuelle possède des lecteurs IDE.
VMHasSnap	VMHasSnap	Valeur booléenne	VRAI si un snapshot VMware de la machine virtuelle est actuellement actif.
VMHasVDSName	vmHasVdsName	Valeur booléenne	VRAI si la machine virtuelle a un nom affiché valide s'il est utilisé comme nom d'hôte.
VMHostName	hostName	Chaîne alphanumérique	Nom de la machine virtuelle qui est dérivé d'une recherche inversée de son adresse IP. Les valeurs ne sont pas sensibles à la casse.
VMIsConn	vmIsConn	Valeur booléenne	VRAI si la machine virtuelle est connectée et disponible. Par exemple : si le serveur ESX d'une machine virtuelle est en panne, cette machine virtuelle n'est pas connecté.
VMVersion	vmVersion	Chaîne alphanumérique	Version de VMware de la machine virtuelle. Les valeurs sont sensibles à la casse. Par exemple : vmx-04, vmx-07, vmx-08.
VMXDatastore	vmxDatastore	Chaîne alphanumérique	Nom du datastore vmx (parfois appelé datastore de répertoire vmx ou de configuration). Les valeurs sont sensibles à la casse. Davantage d'informations sur le datastore VMX sont disponibles. Se reporter à Terminologie NetBackup for VMware.
VMXDatastoreFolder	vmxDatastoreFolder	Chaîne alphanumérique	Nom du dossier qui contient les DataStores vmx. Les valeurs ne sont pas sensibles à la casse.
VMXDatastoreNFSHost	vmxDatastoreNfsHost	Chaîne alphanumérique	Nom de l'hôte du NFS du DataStore vmx. Les valeurs ne sont pas sensibles à la casse.
VMXDatastoreNFSPath	vmxDatastoreNfsPath	Chaîne alphanumérique	La structure de dossier qui définit le chemin d'accès à un DataStore de NFS vmx. Utilisez cette option si le nom d'hôte NFS du stockage de données que vous voulez filtrer n'est pas le seul dans votre environnement. Les valeurs ne sont pas sensibles à la casse.
VMXDatastoreType	vmxDatastoreType	Chaîne alphanumérique	Type du DataStore vmx. Les valeurs sont de type NFS ou VMFS. Les valeurs ne sont pas sensibles à la casse.
[attributs personnalisés de vSphere]	[attributs personnalisés de vSphere]	Chaîne alphanumérique	Valeur d'un attribut personnalisé défini dans le client vSphere pour un ou plusieurs machines virtuelles. Remarque : dans le client vSphere, l'attribut doit avoir une valeur pour au moins une machine virtuelle. Le type d'attribut doit être Machine virtuelle. Les valeurs distinguent les majuscules et minuscules. L'exclusion de disques basée sur des attributs personnalisés nécessite que vous entriez dans NetBackup les informations d'authentification pour le ou les serveurs vCenter qui hébergent les machines virtuelles. Les informations d'authentification du serveur ESXi ne sont pas suffisantes. Se reporter à Ajout d'informations d'authentification NetBackup pour VMware.

Opérateurs

Tableau : Opérateurs dans la liste déroulante Opérateur présente les opérateurs disponibles dans la liste déroulante Opérateur. Notez que dans certains cas, l'opérateur utilisé dans la console d'administration NetBackup est différent de celui utilisé dans l'interface utilisateur Web NetBackup.

Remarque :

Utilisez les opérateurs OData uniquement lorsque vous générez des requêtes à l'aide du mode avancé de l'interface utilisateur Web NetBackup sous Générateur de requêtes ou des API NetBackup.

Tableau : Opérateurs dans la liste déroulante Opérateur

Opérateur	Opérateur OData	Description
AnyOf (console d'administration NetBackup) Dans (interface utilisateur Web NetBackup)	dans	Correspond à toutes les valeurs spécifiées dans le champ Valeur(s). Par exemple : Si les serveurs ESX dans le champ Valeur(s) sont "ESX01", "ESX02, "ESX03", Any Of correspond à tout serveur ESX qui porte l'un de ces noms. Si les noms de vos serveurs ne sont pas identiques à l'une des valeurs spécifiées, aucune correspondance n'est trouvée. Un serveur nommé ESX01A ne sera pas retenu.
Contains	contains	Correspond à la valeur dans le champ Valeur(s), où que se trouve la valeur dans la chaîne. Par exemple : si l'entrée Valeurs est "dev", Contains trouve une correspondance avec des chaînes telles que "01dev", "01dev99", "devOP" et "Development_machine"
EndsWith	endswith	Correspond à la valeur du champ Valeur(s) lorsqu'elle apparaît à la fin d'une chaîne. Par exemple : si l'entrée Valeurs est "dev", EndsWith trouve une correspondance avec la chaîne "01dev" mais pas avec "01dev99", "devOP" ou "Development_machine".
Equal	eq	Correspond uniquement à la valeur spécifiée dans le champ Valeur(s). Par exemple : Si le nom affiché à rechercher est "VMtest27", Equal trouve une correspondance avec les noms de machines virtuelles tels que VMTest27, vmtest27 ou vmTEST27 et ainsi de suite. Le nom VMtest28 ne correspond pas.
Greater	gt	Correspond à n'importe quelle valeur supérieure aux valeurs spécifiées, selon l'ordre d'interclassement UTF-8.
GreaterEqual	ge	Correspond à n'importe quelle valeur supérieure ou égale aux valeurs spécifiées, selon l'ordre d'interclassement UTF-8.
IsSet (console d'administration NetBackup) NotEqual nullIn (interface utilisateur Web NetBackup)	ne null	Détermine si une valeur est renvoyée pour le mot-clé Field. Utilisez IsSet avec une autre règle, en tant que condition, pour vous assurer que la requête sélectionne les machines virtuelles appropriées. Notez que vous ne réalisez pas de saisie sous Valeurs pour une règle qui utilise IsSet. Se reporter à L'opérateur IsSet dans les requêtes. Se reporter à Incidence du paramètre Identifiant de la VM principale sur la colonne Sélection des résultats du Test de requête. Se reporter à Test de requête : échec des machines virtuelles.
Less	lt	Correspond à n'importe quelle valeur inférieure aux valeurs spécifiées, selon l'ordre d'interclassement UTF-8.
LessEqual	le	Correspond à n'importe quelle valeur inférieure ou égale aux valeurs spécifiées, selon l'ordre d'interclassement UTF-8.
NotEqual	ne	Correspond à n'importe quelle valeur qui n'est pas égale à la valeur du champ Valeur(s).
StartsWith	startswith	Correspond à la valeur du champ Valeur(s) lorsqu'elle apparaît au début d'une chaîne. Par exemple : si l'entrée Valeur(s) est « box », StartsWith trouve une correspondance avec la chaîne « box_car » mais pas avec « flatbox ».

Valeur(s)

Tableau : Caractères acceptés dans le champ Valeur(s) décrit les caractères qui peuvent être entrés dans le champ Valeur(s). Le mot-clé de Champ détermine la sensibilité à la casse.

Remarque :

La chaîne de caractères que vous entrez dans le champ Valeurs doit être entourée par des apostrophes ou des guillemets.

Tableau : Caractères acceptés dans le champ Valeur(s)

Types de caractères	Caractères de chaîne autorisés
Alphanumériques	A à Z, a à z, 0 à 9, - (signe moins) et caractères spéciaux. Remarque : Nombres décimaux uniquement.
Caractères génériques	Le symbole * (astérisque) correspond à tout. Par exemple : "prod" correspond à la chaîne "prod" précédée et/ou suivie de n'importe quels caractères. ? (point d'interrogation) correspond à n'importe quel caractère unique. Par exemple : "prod??" correspond à la chaîne "prod" suivie de deux caractères quelconques.
Caractère d'échappement	Le symbole \ (barre oblique inverse) retire sa valeur spéciale au caractère générique ou au métacaractère qui le suit. Par exemple : pour rechercher une chaîne qui contient un astérisque (tel que test), entrez "test\"
Guillemets	Remarque : les caractères que vous entrez dans le champ Valeurs doivent être entourés par des guillemets ou des apostrophes. Pour rechercher une chaîne qui contient des guillemets, ajoutez un caractère d'échappement devant chaque guillemet (\") ou entourez la chaîne entière par des apostrophes. Par exemple : pour rechercher une chaîne qui contient des guillemets (telle que "name"), entrez '"name"' (entre apostrophes) ou "\"name\""