Boîte de dialogue Modification avancée (Condition)

Utilisez la boîte de dialogue Modification avancée afin de créer des expressions complexes pour des conditions de la Gestion basée sur des stratégies.

Options

• Valeur de cellule
  Affiche la fonction ou l'expression qui sera utilisée pour la valeur de cellule lorsque vous la créez. Lorsque vous cliquez sur OK, la valeur de cellule apparaît dans la cellule Champ ou Valeur dans la zone d'expression de condition de la boîte de dialogue Créer une nouvelle condition ou Ouvrir une condition de la page Général.

• Fonctions et propriétés
  Affiche les fonctions et propriétés disponibles.

• Détails
  Affiche les informations relatives aux fonctions et propriétés, au format suivant : signature de fonction, description de fonction, valeur de retour et exemple.

Syntaxe

Les expressions valides doivent avoir le format suivant :

{property | function | constant}

{operator}

{property | function | constant}

Exemples

Voici quelques exemples d'expressions valides :

• Property1 > 5

• Property1 = Property2

• Ajoutez(5, Multiply(.2, Property1)) < Property2

• Sometext IN Property1

• Property1 < Fn(Property2)

• BitwiseAnd(Property1, Property2) = 0

Informations supplémentaires sur les fonctions

Les sections suivantes fournissent des informations supplémentaires sur les fonctions que vous pouvez utiliser afin de créer des expressions complexes pour des conditions de la Gestion basée sur des stratégies.

Important

Les fonctions que vous pouvez utiliser pour créer des conditions de Gestion basée sur des stratégies n'utilisent pas toujours la syntaxe Transact-SQL. Veillez à suivre l'exemple de syntaxe. Par exemple, lorsque vous utilisez les fonctions DateAdd ou DatePart, vous devez placer l'argument datepart entre guillemets simples.

Fonction	Description
Add()	Signature de fonction : Numeric Add (Numeric expression1, Numeric expression2) Description de fonction : Ajoute deux nombres. Arguments : expression1 et expression2 - Toute expression valide de l'un des types de données de la catégorie numeric, à l'exception du type de données bit. Peut être une constante, une propriété ou une fonction qui retourne un type numérique. Valeur de retour : Retourne le type de données de l'argument ayant la précédence la plus élevée. Exemple : Add(Property1, 5)
Array()	Signature de fonction : Array Array (VarArgs expression) Description de fonction : Crée un tableau à partir d'une liste de valeurs. Peut être utilisée avec des fonctions d'agrégation telles que Sum() et Count(). Arguments : expression - Expression destinée à être convertie en tableau. Valeur de retour : Le tableau. Exemple : Array(2,3,4,5,6)
Avg()	Signature de fonction : Numeric Avg (VarArgs) Description de fonction : Retourne la moyenne des valeurs dans la liste d'arguments. Arguments : VarArgs- Liste d'expressions Variant de la catégorie de type de données numérique exacte ou approchée, à l'exception du type bit. Valeur de retour : Le type retourné est déterminé par le type du résultat d'expression évalué. Si le résultat de l'expression est de catégorie integer, decimal, money et smallmoney, float et real, les types de retour sont int, decimal, money et float ; respectivement. Exemple : Avg(1.0, 2.0, 3.0, 4.0, 5.0) retourne 3.0 dans cet exemple.
BitwiseAnd()	Signature de fonction : Numeric BitwiseAnd (Numeric expression 1, Numeric expression2) Description de fonction : Exécute une opération logique AND au niveau du bit entre deux valeurs entières. Arguments : expression1 et expression2 - Toute expression valide de tout type de données dans la catégorie de types de données integer. Valeur de retour : Retourne une valeur de catégorie de type de données integer. Exemple : BitwiseAnd(Property1, Property2)
BitwiseOr()	Signature de fonction : Numeric BitwiseOr (Numeric expression1, Numeric expression2) Description de fonction : Exécute une opération logique OR au niveau du bit entre deux valeurs entières spécifiées. Arguments : expression1 et expression2 - Toute expression valide de tout type de données dans la catégorie de types de données integer. Valeur de retour : Retourne une valeur de catégorie de type de données integer. Exemple : BitwiseOr(Property1, Property2)
Concatenate()	Signature de fonction : String Concatenate (String string1, String string2) Description de fonction : Concatène deux chaînes. Arguments : string1 et string2 - Les deux chaînes à concaténer. Peuvent être n'importe quelle chaîne valide non Null. Valeur de retour : La chaîne concaténée, avec string1 suivie de string2. Exemple : Concatenate("Hello", " World") retourne "Hello World".
Count()	Signature de fonction : Numeric Count (VarArgs) Description de fonction : Retourne le nombre d'éléments contenus dans la liste d'arguments. Arguments : VarArgs - Expression de tout type à l'exception de text, image et ntext. Valeur de retour : Retourne une valeur de catégorie de type de données integer. Exemple : Count(1.0, 2.0, 3.0, 4.0, 5.0) retourne 5 dans cet exemple.
DateAdd()	Signature de fonction : DateTime DateAdd (String datepart, Numeric number, DateTime date) Description de fonction : Retourne une nouvelle valeur datetime basée sur l'ajout d'un intervalle à la date spécifiée. Arguments : datepart - Paramètre qui spécifie sur quelle partie de la date retourner une nouvelle valeur. Parmi les types pris en charge, citons : year(yy, yyyy), month (mm, m) et dayofyear(dy, y). Pour plus d'informations, consultez DATEADD (Transact-SQL). number - Valeur utilisée pour incrémenter datepart. date - Expression qui retourne une valeur datetime ou une chaîne de caractères dans un format de date. Valeur de retour : Nouvelle valeur datetime basée sur l'ajout d'un intervalle à la date spécifiée. Exemple : DateAdd('day', 21, DateTime('2007-08-06 14:21:50')) retourne '2007-08-27 14:21:50' dans cet exemple. Le tableau ci-dessous répertorie les dateparts et les abréviations pris en charge par cette fonction. Partie de date Abréviations year yy, yyyy month mm, m dayofyear dy, y day dd, d week wk, ww weekday dw, w hour hh minute mi, n second ss, s millisecond ms
DatePart()	Signature de fonction : Numeric DatePart (String datepart, DateTime date) Description de fonction : Retourne un entier qui représente l'élément datepart spécifié de la date donnée. Arguments : datepart - Paramètre qui spécifie la partie de la date à retourner. Parmi les types pris en charge, citons : year(yy, yyyy), month (mm, m) et dayofyear(dy, y). Pour plus d'informations, consultez DATEPART (Transact-SQL). date - Expression qui retourne une valeur datetime ou une chaîne de caractères dans un format de date. Valeur de retour : Retourne la valeur d'une catégorie de type de données integer qui représente l'élément datepart spécifié de la date donnée. Exemple : DatePart('month', DateTime('2007-08-06 14:21:50.620')) retourne 8 dans cet exemple.
DateTime()	Signature de fonction : DateTime DateTime (String dateString) Description de fonction : Crée une valeur datetime à partir d'une chaîne. Arguments : dateString - Valeur datetime sous forme de chaîne. Valeur de retour : Renvoie une valeur datetime créée à partir de la chaîne d'entrée. Exemple : DateTime('3/12/2006')
Divide()	Signature de fonction : Numeric Divide (Numeric expression_dividend, Numeric expression_divisor) Description de fonction : Divise un nombre par un autre. Arguments : expression_dividend - Expression numérique à diviser. Le dividende peut être toute expression valide de l'un des types de données de la catégorie des types de données numériques, sauf le type de données datetime. expression_divisor - Expression numérique par laquelle diviser le dividende. Le diviseur peut être toute expression valide de l'un des types de données de la catégorie des types de données numériques, sauf le type de données datetime. Valeur de retour : Retourne le type de données de l'argument ayant la précédence la plus élevée. Exemple : Divide(Property1, 2) [!REMARQUE] Il s'agit d'une double opération. Pour effectuer une comparaison d'entiers, vous devez combiner les résultats avec Round(). Exemple : Round(Divide(10, 3), 0) = 3.
Enum()	Signature de fonction : Numeric Enum (String enumTypeName, String enumValueName) Description de fonction : Crée une valeur enum à partir d'une chaîne. Arguments : enumTypeName - Nom du type enum. enumValueName - Valeur de l'enum. Valeur de retour : Retourne la valeur enum sous forme de valeur numérique. Exemple : Enum('CompatibilityLevel','Version100')
Escape()	Signature de fonction : String Escape (String replaceString, String stringToEscape, String escapeString) Description de fonction : Place dans une séquence d'échappement une sous-chaîne de la chaîne d'entrée avec une chaîne d'échappement donnée. Arguments : replaceString - Chaîne d'entrée. stringToEscape - Sous-chaîne de replaceString. Il s'agit de la chaîne devant laquelle ajouter une chaîne d'échappement. escapeString – Chaîne d'échappement à ajouter devant chaque instance de stringToEscape. Valeur de retour : Retourne un replaceString modifié dans lequel chaque instance de stringToEscape est précédée de escapeString. Exemple : Escape("Hello", "l", "[") retourne "He[l[lo".
ExecuteSQL()	Signature de fonction : Variant ExecuteSQL (String returnType, String sqlQuery) Description de fonction : Exécute la requête Transact-SQL contre le serveur cible. Arguments : returnType - Spécifie le type de retour des données retournées par l'instruction Transact-SQL. Les littéraux valides pour returnType sont les suivantes : Numeric, String, Bool, DateTime, Array et Guid. sqlQuery - Chaîne qui contient la requête à exécuter. Exemple : ExecuteSQL ('Numeric', 'SELECT COUNT(*) FROM msdb.dbo.sysjobs') <> 0 Exécute une requête Transact-SQL scalaire dans une instance cible de SQL Server. Une seule colonne peut être spécifiée dans une instruction SELECT ; les colonnes supplémentaires au delà de la première sont ignorées. La requête obtenue ne doit retourner qu'une seule ligne ; les lignes supplémentaires au-delà de la première sont ignorées. Si la requête retourne un jeu vide, l'expression de condition créée autour de ExecuteSQL prendra la valeur false. ExecuteSql prend en charge les modes d'évaluation À la demande et Selon la planification. @@ObjectName - Correspond au champ de nom dans sys.objects. La variable sera remplacée par le nom de l'objet actuel. @@ObjectSchema - Correspond au champ de nom dans sys.schemas. La variable sera remplacée par le nom du schéma pour l'objet actuel, le cas échéant. [!REMARQUE] Pour inclure un guillemet simple dans une instruction ExecuteSQL, ajoutez au guillemet simple un deuxième guillemet simple. Par exemple, pour inclure une référence à un utilisateur nommé O'Brian, tapez O"Brian.
ExecuteWQL()	Signature de fonction : Variant ExecuteWQL (string returnType , string namespace, string wql) Description de fonction : Exécute le script WQL sur l'espace de noms fourni. L'instruction Select ne peut contenir qu'une seule colonne de retour. Si plusieurs colonnes sont fournies, une erreur est générée. Arguments et définition de type de retour returnType - Spécifie le type de retour des données retournées par le WQL. Les littéraux valides sont Numeric, String, Bool, DateTime, Array et Guid. namespace - Espace de noms WMI sur lequel effectuer l'exécution. wql - Chaîne qui contient le WQL à exécuter. Exemple : ExecuteWQL('Numeric', 'root\CIMV2', 'select NumberOfProcessors from win32_ComputerSystem') <> 0
False()	Signature de fonction : Bool False() Description de fonction : Retourne la valeur booléenne FALSE. Valeur de retour : Retourne la valeur booléenne FALSE. Exemple : IsDatabaseMailEnabled = False()
GetDate()	Signature de fonction : DateTime GetDate() Description de fonction : Retourne la date système. Valeur de retour : Retourne la date système sous forme de valeur DateTime. Exemple : @DateLastModified = GetDate()
Guid()	Signature de fonction : Guid Guid(String guidString) Description de fonction : Retourne un GUID à partir d'une chaîne. Arguments : guidString - Représentation sous forme de chaîne du GUID à créer. Valeur de retour : Retourne le GUID créé à partir de la chaîne. Exemple : Guid('12340000-0000-3455-0000-000000000454')
IsNull()	Signature de fonction : Variant IsNull (Variant check_expression, Variant replacement_value) Description de fonction : La valeur de check_expression est retournée si elle n'est pas NULL ; autrement, replacement_value est retournée. Si les types sont différents, replacement_value est convertie implicitement au type de check_expression. Arguments : check_expression - Expression dans laquelle la valeur NULL est recherchée. check_expression peut être de tout type pris en charge par la gestion basée sur des stratégies : Numeric, String, Bool, DateTime, Array et Guid. replacement_value - Expression à retourner si check_expression est NULL. replacement_value doit appartenir à un type implicitement converti dans le type de check_expression. Valeur de retour : Le type de retourne est de type check_expression si check_expression n'est pas NULL ; autrement, le type de replacement_value est retourné.
Len()	Signature de fonction : Numeric Len (string_expression) Description de fonction : Retourne le nombre de caractères de l'expression de chaîne donnée, à l'exclusion des espaces à droite. Arguments : string_expression - Expression de chaîne à évaluer. Valeur de retour : Retourne une valeur de catégorie de type de données integer. Exemple : Len('Hello') retourne 5 dans cet exemple.
Lower()	Signature de fonction : String Lower (String_expression) Description de fonction : Retourne la chaîne après avoir converti tous les caractères majuscules en minuscules. Arguments : expression - Expression de chaîne source. Valeur de retour : Retourne une chaîne qui représente l'expression de chaîne source après que tous les caractères majuscules ont été convertis en minuscules. Exemple : Len('HeLlO') retourne 'hello' dans cet exemple.
Mod()	Signature de fonction : Numeric Mod (Numeric expression_dividend, Numeric expression_divisor) Description de fonction : Fournit le reste entier de la division de la première expression numérique par la deuxième expression numérique. Arguments : expression_dividend - Expression numérique à diviser. expression_dividend doit être une expression valide de l'un des types de données des catégories de données integer (entier) ou numeric (numérique). expression_divisor - Expression numérique par laquelle diviser le dividende. expression_divisor doit être une expression valide de l'un des types de données des catégories de données integer (entier) ou numeric (numérique). Valeur de retour : Retourne une valeur de catégorie de type de données integer. Exemple : Mod(Property1, 3)
Multiply()	Signature de fonction : Numeric Multiply (Numeric expression1, Numeric expression2) Description de fonction : Multiplie deux expressions. Arguments : expression1 et expression2 - Toute expression valide de l'un des types de données de la catégorie numeric, à l'exception du type de données datetime. Valeur de retour : Retourne le type de données de l'argument ayant la précédence la plus élevée. Exemple : Multiply(Property1, .20)
Power()	Signature de fonction : Numeric Power (Numeric numeric_expression, Numeric expression_power) Description de fonction : Retourne la valeur de l'expression spécifiée à la puissance spécifiée. Arguments : numeric_expression - Expression de la catégorie de type de données numérique exacte ou approximative, à l'exception du type de données bit. expression_power- Représente la puissance à laquelle élever numeric_expression. expression_power peut être une expression de type numérique exact ou approximatif, à l'exception du type de données bit. Valeur de retour : La valeur de retour est la même que numeric_expression. Exemple : Power(Property1, 3)
Round()	Signature de fonction : Numeric Round (Numeric expression, Numeric expression_precision) Description de fonction : Retourne une expression numérique, arrondie à la longueur ou à la précision indiquée. Arguments : expression - Expression de type numérique exact ou approché, à l'exception du type bit. expression_precision - Précision avec laquelle l'expression doit être arrondie. Lorsque expression_precision est un nombre positif, numeric_expression est arrondie au nombre de décimales indiqué par length. Lorsque expression_precision est un nombre négatif, numeric_expression est arrondie à gauche de la virgule décimale, selon l'indication fournie par expression_precision. Valeur de retour : Retourne le même type que numeric_expression. Exemple : Round(5.333, 0)
String()	Signature de fonction : String String (Variant_expression) Description de fonction : Convertit une variante en chaîne. Arguments : expression - Expression de type Variant à convertir en chaîne. Valeur de retour : Retourne la valeur de l'expression Variant sous forme de chaîne. Exemple : String(4)
Sum()	Signature de fonction : Numeric Sum (VarArgs) Description de fonction : Retourne la somme de toutes les valeurs dans la liste d'arguments. Sum peut être utilisée avec des valeurs numériques. Arguments : VarArgs- Liste d'expressions Variant de la catégorie de type de données numérique exacte ou approchée, à l'exception du type bit. Valeur de retour : Retourne le total de toutes les valeurs d'expression dans le type de données d'expression le plus précis. Si le résultat de l'expression est de catégorie integer, numeric, money et small money, float et real, les types de retour sont int, numeric, money et float ; respectivement. Exemple : Sum(1.0, 2.0, 3.0, 4.0, 5.0) retourne 15 dans cet exemple.
True()	Signature de fonction : Bool TRUE() Description de fonction : Retourne la valeur booléenne TRUE. Valeur de retour : Retourne la valeur booléenne TRUE. Exemple : IsDatabaseMailEnabled = True()
Upper()	Signature de fonction : String Upper (String_expression) Description de fonction : Retourne la chaîne après avoir converti tous les caractères minuscules en majuscules. Arguments : expression - Expression de chaîne source. Valeur de retour : Retourne une chaîne qui représente l'expression de chaîne source après que tous les caractères minuscules ont été convertis en majuscules. Exemple : Len('HeLlO') retourne 'HELLO' dans cet exemple.

Voir aussi

Référence

Boîte de dialogue Créer une nouvelle condition ou Ouvrir une condition, page Général

Concepts

Administrer des serveurs à l'aide de la Gestion basée sur des stratégies