Commande PowerShell

Commande

• Source : Définit la source de la commande qui est envoyée.

  • Commande(s) intégrée(s) :

  • Valeur : Utilisez la zone de saisie prévue pour saisir les données que vous souhaitez que l'action utilise. Autrement, vous pouvez ajouter une variable pour définir les données ou ajouter un caractère spécial à la valeur saisie.

  • Importer : Ouvre la boîte de dialogue Ouvrir un fichier où rechercher et sélectionner un fichier contenant les données souhaitées. Le contenu du fichier est importé dans la zone de saisie Valeur.

  • Exporter : Ouvre la boîte de dialogue Enregistrer le fichier pour vous permettre d'enregistrer le contenu de la zone de saisie Valeur dans un fichier externe. Vous pouvez enregistrer la valeur dans un nouveau fichier ou remplacer le contenu d'un fichier existant.

  • Modifier la valeur intrinsèque : Ouvre la boîte de dialogue Valeur pour où vous pouvez éditer la valeur de la source intégrée.

  • Variable :

    • Variable : Saisissez la variable que vous souhaitez utiliser pour la source. Autrement, cliquez sur pour sélectionner une variable récemment utilisée ou cliquez sur Plus de variables pour ouvrir la boîte de dialogue Insérer une variable.

  • Fichier externe :

    • Emplacement : Indique le système de fichiers où se trouve le dossier source. Les systèmes ou emplacements de fichiers peuvent comprendre des systèmes de fichiers locaux ou sur réseau, Librarian, voire un emplacement de stockage sur le cloud. Pour en savoir plus sur les emplacements de stockage cloud pris en charge, consultez Administration Console Page de Stockage cloud.

    • Nom du fichier : Indique le chemin du fichier. Vous pouvez saisir l’emplacement du dossier et le nom du fichier ou cliquer sur Parcourir pour trouver et sélectionner le fichier que vous souhaitez. Autrement, vous pouvez ajouter une variable pour définir le fichier ou ajouter un caractère spécial à la valeur saisie.

    • Codage de fichier : Définit le codage qui est utilisé par le fichier source.

• Exécuter par lot : Indique que le fichier spécifié est exécuté en tant que fichier de lot. Disponible lorsque la valeur Source est réglée sur Fichier externe et la valeur Emplacement est réglée sur Ordinateur/réseau.

  • Paramètres : Spécifie les paramètres qui sont transmis au fichier de lot. Disponible lorsque Exécuter par lot est sélectionné.

• Attendre que la commande se termine : Indique que la commande n'est exécutée qu'après la réception d’une réponse. Si cette option n'est pas sélectionnée, la commande est exécutée sans attendre de réponse.

  • Délai d'exécution (secondes) : Spécifie le temps pendant lequel l'action permet à la commande de s'exécuter avant que l'action n’expire.

Sortie

• Envoyer la sortie de commande au journal de messages : Journalise la sortie de commande shell dans le journal de messages.

Pour chacune des options suivantes, vous pouvez saisir la variable que vous souhaitez. Autrement, vous pouvez aussi ajouter une variable.

• Enregistrer la sortie et les erreurs de commande dans la variable : Indique la variable dans laquelle sont enregistrées la sortie et les erreurs de la commande.

• Enregistrer les erreurs de commande dans la variable : Indique la variable dans laquelle sont enregistrées les erreurs de la commande.

• Enregistrer les exceptions de commande dans la variable : Indique la variable dans laquelle sont enregistrées les exceptions de la commande.

Action

• Nom : Indique le nom de l'action. Vous pouvez remplacer le nom par défaut en saisissant un nouveau nom dans le champ.

• Description : Présente une description de l’action.

• Exécuter une action : Pour définir la fréquence à laquelle l'action doit être exécutée.

  • Toujours : Indique que l'action est exécutée à chaque fois que l'événement se produit.

  • Jamais : Indique que l'action n’est pas exécutée lorsque l'événement se produit.

  • Sous conditions, en fonction de la variable : Indique que l'action est uniquement exécutée lorsqu’une variable sélectionnée répond à une condition spécifiée. Utiliser cette option dans les situations où une seule condition détermine l'exécution de l'action. Après avoir sélectionné cette option, vous pouvez créer l'instruction conditionnelle dans la zone de saisie.

    Contrôles de zone de saisie

    • Variable : Indique la variable que vous souhaitez utiliser pour l'instruction conditionnelle. Saisissez la variable dans la zone de saisie. Cliquer sur pour voir une liste de variables récemment utilisées ou cliquer sur Plus de variables pour ouvrir la boîte de dialogue Insérer une variable.

    • [Opérateur relationnel]: Définit l'opérateur relationnel à utiliser pour l'énoncé conditionnel. Cliquez sur l'opérateur existant pour afficher une liste contenant d'autres opérateurs, puis cliquez sur celui que vous souhaitez utiliser. Pour en savoir plus, reportez-vous à la rubrique Opérateurs relationnels. Les opérateurs qui sont disponibles dans la liste dépendent de si vous avez sélectionné Texte ou Décimal pour l'option Type.

    • Valeur : Définit les valeurs à utiliser pour l'instruction conditionnelle. Pour ajouter une valeur, cliquez sur , cliquez sur <saisir une valeur>, saisissez la valeur souhaitée, puis appuyez sur Enter. Pour supprimer une valeur, utilisez le bouton secondaire de la souris pour cliquer dessus, puis cliquez sur Supprimer. Pour certains opérateurs, par exemple Est vide et N'est pas vide, il n'est pas nécessaire de définir de valeur. Dans ces cas, le champ Valeur n'est pas disponible.

    • Type : Indique si l'énoncé conditionnel évalue un texte ou une valeur décimale.

  • Sous conditions, en fonction de l'expression : Spécifie les conditions dans lesquelles l'action est exécutée. Utilisez cette option pour les situations nécessitant plusieurs énoncés conditionnels. Lorsque vous sélectionnez cette option, vous pouvez créer l'instruction conditionnelle dans la zone de saisie en créant les instructions conditionnelles de votre choix. Vous pouvez créer et éditer l'expression conditionnelle dans l'onglet Vue arborescente. Cliquez sur l'onglet Vue arborescente pour afficher une vue en lecture seule de l'expression conditionnelle.

    Contrôles de zone de saisie (onglet Vue arborescente)

    • [Opérateur conditionnel]: Définit l'opérateur conditionnel pour les énoncés conditionnels du groupe. L'opérateur conditionnel par défaut est And.

      Cliquez sur l'opérateur conditionnel existant pour afficher un menu que vous pouvez utiliser pour configurer votre expression conditionnelle d'une des manières suivantes :

      • And, Or, NotAnd, NotOr : Cliquez sur l'opérateur conditionnel que vous souhaitez utiliser pour les instructions conditionnelles. Pour en savoir plus sur les opérateurs conditionnels pris en charge, consulter Opérateurs conditionnels.

      • Ajouter une condition : Cliquez pour ajouter un autre énoncé conditionnel au groupe actuel.

      • Ajouter groupe : Cliquez pour ajouter un sous-groupe d'instructions conditionnelles au groupe actuel.

      • Supprimer le groupe : Cliquez sur pour supprimer le sous-groupe. Disponible lorsque vous ouvrez le menu à partir d'un sous-groupe.

      • Tout supprimer : Cliquez pour supprimer tous les énoncés conditionnels (y compris les sous-groupes). Disponible lorsque vous ouvrez le menu à partir du groupe supérieur.

    • : Ajoute une instruction conditionnelle au groupe associé à cet opérateur. Visible à droite de chaque opérateur conditionnel de votre expression.

    •  :  Supprime l’instruction conditionnelle. Visible à droite d'une instruction conditionnelle existante lorsque vous pointez sur l'instruction.

    • Variable : Indique la variable que vous souhaitez utiliser pour l'instruction conditionnelle. Saisissez la variable dans la zone de saisie. Cliquer sur pour voir une liste de variables récemment utilisées ou cliquer sur Plus de variables pour ouvrir la boîte de dialogue Insérer une variable.

    • [Opérateur relationnel]: Définit l'opérateur relationnel à utiliser pour l'énoncé conditionnel. Cliquez sur l'opérateur existant pour afficher une liste contenant d'autres opérateurs, puis cliquez sur celui que vous souhaitez utiliser. Pour en savoir plus, reportez-vous à la rubrique Opérateurs relationnels. Les opérateurs qui sont disponibles dans la liste dépendent de si vous avez sélectionné Texte ou Décimal pour l'option Type.

    • Valeur : Définit les valeurs à utiliser pour l'instruction conditionnelle. Pour ajouter une valeur, cliquez sur , cliquez sur <saisir une valeur>, saisissez la valeur souhaitée, puis appuyez sur Enter. Pour supprimer une valeur, utilisez le bouton secondaire de la souris pour cliquer dessus, puis cliquez sur Supprimer. Pour certains opérateurs, par exemple Est vide et N'est pas vide, il n'est pas nécessaire de définir de valeur. Dans ces cas, le champ Valeur n'est pas disponible.

    • Type : Indique si l'énoncé conditionnel évalue un texte ou une valeur décimale.

Erreur de traitement et diagnostic

• Ignorer les erreurs et continuer à exécuter les actions : Indique que lorsque cette option échoue, les autres actions continueront à être exécutées. Si elle n’est pas sélectionnée et que l'action échoue, le comportement résultant dépend de plusieurs facteurs, comme suit :

  L'action s'inscrit dans une action du Groupe

  • Si vous avez spécifié De manière séquentielle pour la propriété Exécuter les actions sur l’onglet Exécution du Groupe, aucune autre action n'est exécutée dans cette action de groupe. Aucune action en dehors de cette action du Groupe n'est affectée.

  • Si vous avez spécifié En parallèle pour la propriété Exécuter les actions sur l’onglet Exécution du Groupe, les erreurs sont ignorées et les autres actions dans ce Groupe sont exécutées. Aucune action en dehors de cette action du Groupe n'est affectée.

  L'action ne s'inscrit pas dans une action du Groupe

  • Si vous avez spécifié De manière séquentielle pour la propriété Exécuter les actions sur l’onglet Exécution de l’événement, aucune autre action n'est exécutée dans l’événement.

  • Si vous avez spécifié En parallèle pour la propriété Exécuter les actions sur l’onglet Exécution de l’événement, les erreurs sont ignorées et les autres actions dans l’événement sont exécutées.

• Réessayer en cas d'échec : Spécifie que si l'action échoue, BarTender essaie de l'exécuter à nouveau.

  • Nombre maximum de nouvelles tentatives : Indique le nombre maximum de tentatives de réexécution de l'action par BarTender. Disponible lorsque l'option Réessayer en cas d'échec est sélectionnée.

  • Intervalle de nouvelles tentatives : Indique la durée d'attente de BarTender après que l’action échoue avant de tenter de réexécuter l'action. Disponible lorsque l'option Réessayer en cas d'échec est sélectionnée.