“高级编辑”(条件)对话框

**“高级编辑”**对话框用于为基于策略的管理条件创建复杂表达式。

选项

  • 单元值
    在创建用于单元值的函数或表达式时,显示相应的函数或表达式。 单击**“确定”以后,在“常规”页的“创建新条件”对话框或“打开条件”对话框中,单元值就会出现在条件表达式框的“字段”单元或“值”**单元。

  • 函数和属性
    显示可用的函数和属性。

  • 详细信息
    使用以下格式显示函数和属性的相关信息:函数签名、函数说明、返回值以及示例。

语法

有效表达式必须采用以下格式:

{property | function | constant}

{operator}

{property | function | constant}

示例

下面是一些有效表达式示例:

  • Property1 > 5

  • Property1 = Property2

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

  • Sometext INProperty1

  • Property1 < Fn(Property2)

  • BitwiseAnd(Property1, Property2) = 0

其他函数信息

以下各节提供某些函数的附加信息,这些函数可用于为基于策略的管理条件创建复杂表达式。

重要说明重要提示

可用于创建基于策略的管理条件的函数并不总是使用 Transact-SQL 语法。 请务必遵从示例语法。 例如,如果使用 DateAdd 函数或 DatePart 函数,则必须用单引号将 datepart 参数括起来。

函数

说明

Add()

函数签名:Numeric Add (Numeric expression1, Numeric expression2)

函数说明:两个数字相加。

参数:

  • expression1 和 expression2 - 数值类别的任一数据类型(bit 数据类型除外)的任意有效表达式。 可以为常量、属性或返回数值类型的函数。

返回值:返回优先级高的参数的数据类型。

示例: Add(Property1, 5)

Array()

函数签名:Array Array (VarArgs expression)

函数说明:根据值列表创建数组。 可与聚合函数(如 Sum() 和 Count())配合使用。

参数:

  • expression - 将要转换为数组的表达式。

返回值:数组。

示例: Array(2,3,4,5,6)

Avg()

函数签名:Numeric Avg (VarArgs)

函数说明:返回参数列表中各值的平均值。

参数:

  • VarArgs - 精确或近似数值数据类型类别(bit 数据类型除外)的变量表达式列表。

返回值:返回类型是由表达式计算结果的类型确定的。

如果表达式结果为 integer、decimal、money (smallmoney)、float 和 real 类别,则返回类型分别为 int、decimal、money 和 float。

示例:在本示例中, Avg(1.0, 2.0, 3.0, 4.0, 5.0) 返回 3.0。

BitwiseAnd()

函数签名:Numeric BitwiseAnd (Numeric expression 1, Numeric expression2)

函数说明:对两个整数值执行位与逻辑运算。

参数:

  • expression1 和 expression2 - 整数数据类型类别的任一数据类型的任意有效表达式。

返回值:返回一个整数数据类型类别的值。

示例: BitwiseAnd(Property1, Property2)

BitwiseOr()

函数签名:Numeric BitwiseOr (Numeric expression1, Numeric expression2)

函数说明:对两个指定的整数值执行位或逻辑运算。

参数:

  • expression1 和 expression2 - 整数数据类型类别的任意数据类型的任何有效表达式。

返回值:返回一个整数数据类型类别的值。

示例: BitwiseOr(Property1, Property2)

Concatenate()

函数签名:String Concatenate (String string1, String string2)

函数说明:串联两个字符串。

参数:

  • string1 和 string2 - 是您要串联的两个字符串。 可以是任何有效的非空字符串。

返回值:串联的字符串,并且 string1 后跟有 string2。

示例: Concatenate("Hello", " World") returns "Hello World".

Count()

函数签名:Numeric Count (VarArgs)

函数说明:返回参数列表中的项数。

参数:

  • VarArgs - 除 text、image 和 ntext 以外的任何类型的表达式。

返回值:返回一个整数数据类型类别的值。

示例:在本示例中, Count(1.0, 2.0, 3.0, 4.0, 5.0) 返回 5。

DateAdd()

函数签名:DateTime DateAdd (String datepart, Numeric number, DateTime date)

函数说明:该函数在指定日期的基础上加上一个时间间隔得到一个新的 datetime 值,然后返回该新值。

参数:

  • datepart - 此参数指定用于返回新值的日期部分。 支持的一些类型有 year(yy, yyyy)、month(mm, m) 和 dayofyear(dy, y)。 有关详细信息,请参阅 DATEADD (Transact-SQL)

  • number - 用于增加 datepart 的值。

  • date - 返回 datetime 值的表达式,或者是具有日期格式的字符串。

返回值:新的 datetime 值,它是在指定日期的基础上加上一个时间间隔之后得到的结果。

示例:在本示例中,DateAdd('day', 21, DateTime('2007-08-06 14:21:50')) 返回 '2007-08-27 14:21:50'。

下表列出了此函数支持的 dateparts 和缩写形式。

日期部分

缩写形式

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()

函数签名:Numeric DatePart (String datepart, DateTime date)

函数说明:返回一个整数,它表示指定日期的指定 datepart。

参数:

  • datepart - 此参数指定返回的日期部分。 支持的一些类型有 year(yy, yyyy)、month(mm, m) 和 dayofyear(dy, y)。 有关详细信息,请参阅 DATEPART (Transact-SQL)

  • date - 返回 datetime 值的表达式,或者是具有日期格式的字符串。

返回值:返回一个整数数据类型类别的值,表示指定日期的指定 datepart。

示例:在本示例中,DatePart('month', DateTime('2007-08-06 14:21:50.620')) 返回 8。

DateTime()

函数签名: DateTime DateTime (String dateString)

函数说明:根据字符串创建一个 datetime 值。

参数:

  • dateString - 字符串形式的 datetime 值。

返回值:返回一个根据输入字符串创建的 datatime 值。

示例: DateTime('3/12/2006')

Divide()

函数签名:Numeric Divide (Numeric expression_dividend, Numeric expression_divisor)

函数说明:两个数字相除。

参数:

  • expression_dividend - 被除数的数值表达式。 被除数可以是具有数值数据类型类别中任一数据类型(datetime 数据类型除外)的任何有效表达式。

  • expression_divisor - 除数的数值表达式。 除数可以是具有数值数据类型类别中任一数据类型(datetime 数据类型除外)的任何有效表达式。

返回值:返回具有较高优先级的参数的数据类型。

示例:Divide(Property1, 2)

注意注意

这是一个双精度运算。 若要进行整数比较,必须将结果与 Round() 结合。 例如:Round(Divide(10, 3), 0) = 3。

Enum()

函数签名:Numeric Enum (String enumTypeName, String enumValueName)

函数说明:根据字符串创建枚举值。

参数:

  • enumTypeName - 枚举类型的名称。

  • enumValueName - 枚举的值。

返回值:返回数值类型的枚举值。

示例:Enum('CompatibilityLevel','Version100')

Escape()

函数签名:String Escape (String replaceString, String stringToEscape, String escapeString)

函数说明:使用给定的转义字符串将输入字符串的子字符串转义。

参数:

  • replaceString – 输入字符串。

  • stringToEscape – replaceString 的子字符串。 这是您要在前面添加转义字符串的字符串。

  • escapeString – 您要在每个 stringToEscape 实例的前面添加的转义字符串。

返回值:返回修改的 replaceString,其中 stringToEscape 的每个实例的前面都有 escapeString。

示例:Escape("Hello", "l", "[") returns "He[l[lo".

ExecuteSQL()

函数签名:Variant ExecuteSQL (String returnType, String sqlQuery)

函数说明:对目标服务器执行 Transact-SQL 查询。

参数:

  • returnType - 指定 Transact-SQL 语句返回的数据类型。 returnType 的有效文字如下:Numeric、String、Bool、DateTime、Array 和 Guid。

  • sqlQuery - 包含要执行的查询的字符串。

示例: ExecuteSQL ('Numeric', 'SELECT COUNT(*) FROM msdb.dbo.sysjobs') <> 0

针对 SQL Server 的目标实例运行一个标量值 TRANSACT-SQL 查询。 在 SELECT 语句中只能指定一列;第一列之外的其他列将被忽略。 生成的查询应只返回一行;第一行以外的其他行将被忽略。 如果查询返回空集,则围绕 ExecuteSQL 构建的条件表达式的计算结果将为 false。 ExecuteSql 支持按需按计划计算模式。

  • @@ObjectName - 对应于 sys.objects 中的名称字段。 该变量将替换为当前对象的名称。

  • @@ObjectSchema - 对应于 sys.schemas 中的名称字段。 该变量将替换为当前对象的架构名称(如果适用)。

注意注意

若要在 ExecuteSQL 语句中包含单引号,请再使用一个单引号将其转义。 例如,若要加入对用户 O'Brian 的引用,请键入 O''Brian。

ExecuteWQL()

函数签名:Variant ExecuteWQL (string returnType , string namespace, string wql)

函数说明:对提供的命名空间执行 WQL 脚本。 Select 语句只能包含一个返回列。 如果提供多个列,则会引发错误。

参数和返回类型定义

  • returnType - 指定 WQL 返回的数据的返回类型。 有效文字为 Numeric、String、Bool、DateTime、Array 和 Guid。

  • namespace - 要对其执行脚本的 WMI 命名空间。

  • wql - 包含要执行的 WQL 的字符串。

示例: ExecuteWQL('Numeric', 'root\CIMV2', 'select NumberOfProcessors from win32_ComputerSystem') <> 0

False()

函数签名:Bool False()

函数说明:返回布尔值 FALSE。

返回值:返回布尔值 FALSE。

示例: IsDatabaseMailEnabled = False()

GetDate()

函数签名:DateTime GetDate()

函数说明:返回系统日期。

返回值:返回 DateTime 类型的系统日期。

示例: @DateLastModified = GetDate()

Guid()

函数签名:Guid Guid(String guidString)

函数说明:根据字符串返回 GUID。

参数:

  • guidString - 是要创建的 GUID 的字符串表示形式。

返回值:返回根据字符串创建的 GUID。

示例: Guid('12340000-0000-3455-0000-000000000454')

IsNull()

函数签名:Variant IsNull (Variant check_expression, Variant replacement_value)

函数说明:如果 check_expression 的值不为 NULL,则返回这个值;否则返回 replacement_value。 如果类型不同,则将 replacement_value 隐式转换为 check_expression 类型。

参数:

  • check_expression - 将被检查是否为 NULL 的表达式。 check_expression 可以是基于策略的管理支持的任意类型:Numeric、String、Bool、DateTime、Array 和 Guid。

  • replacement_value - check_expression 为 NULL 时要返回的表达式。 replacement_value 必须是可以隐式转换为 check_expression 类型的类型。

返回值:如果 check_expression 不为 NULL,则返回类型为 check_expression 的类型;否则返回 replacement_value 的类型。

Len()

函数签名:Numeric Len (string_expression)

函数说明:返回给定字符串表达式的字符数,不包括尾随空格。

参数:

  • string_expression - 要计算的字符串表达式。

返回值:返回一个整数数据类型类别的值。

示例:在本示例中, Len('Hello') 返回 5。

Lower()

函数签名:String Lower (String_expression)

函数说明:返回将所有大写字符都转换为小写字符后得到的字符串。

参数:

  • expression - 源字符串表达式。

返回值:将所有大写字符都转换为小写字符后,返回一个表示源字符串表达式的字符串。

例如:在本示例中,Len('HeLlO') 返回 'hello'。

Mod()

函数签名:Numeric Mod (Numeric expression_dividend, Numeric expression_divisor)

函数说明:提供第一个数值表达式除以第二个数值表达式后得到的整数余数。

参数:

  • expression_dividend - 被除数的数值表达式。 expression_dividend 必须为整数或数值数据类型类别中任意一种数据类型的有效表达式。

  • expression_divisor - 除数的数值表达式。 expression_divisor 必须为整数或数值数据类型类别中任意一种数据类型的任意有效表达式。

返回值:返回一个整数数据类型类别的值。

示例: Mod(Property1, 3)

Multiply()

函数签名:Numeric Multiply (Numeric expression1, Numeric expression2)

函数说明:将两个表达式相乘。

参数:

  • expression1 和 expression2 - 具有数值类别中任一数据类型(datetime 数据类型除外)的任何有效表达式。

返回值:返回优先级高的参数的数据类型。

示例: Multiply(Property1, .20)

Power()

函数签名:Numeric Power (Numeric numeric_expression, Numeric expression_power)

函数说明:返回指定表达式的指定幂的值。

参数:

  • numeric_expression - 精确或近似数值数据类型类别(bit 数据类型除外)的表达式。

  • expression_power - 以 numeric_expression 为底的幂。 expression_power 可以是精确数字或近似数字数据类型(bit 数据类型除外)类别的表达式。

返回值:返回类型与 numeric_expression 相同。

示例: Power(Property1, 3)

Round()

函数签名:Numeric Round (Numeric expression, Numeric expression_precision)

函数说明:返回一个舍入到指定长度或精度的数值表达式。

参数:

  • expression - 精确或近似数值数据类型类别(bit 数据类型除外)的表达式。

  • expression_precision - 表达式的舍入精度。 如果 expression_precision 为正数,则将 numeric_expression 舍入到该长度指定的小数位数。 如果 expression_precision 为负数,则将 numeric_expression 小数点左边部分舍入到 expression_precision 指定的长度。

返回值:返回与 numeric_expression 相同的类型。

示例: Round(5.333, 0)

String()

函数签名:String String (Variant_expression)

函数说明:将变量转换为字符串。

参数:

  • expression - 要转换为字符串的变量表达式。

返回值:返回变量表达式的字符串值。

示例: String(4)

Sum()

函数签名:Numeric Sum (VarArgs)

函数说明:返回参数列表中所有值的和。 Sum 可以与数值一起使用。

参数:

  • VarArgs - 精确或近似数值数据类型类别(bit 数据类型除外)的变量表达式列表。

返回值:以最精确的表达式数据类型返回所有表达式值的和。

如果表达式结果为 integer、numeric、money (small money)、float 和 real 类别,则返回类型分别为 int、numeric、money 和 float。

例如:在本示例中,Sum(1.0, 2.0, 3.0, 4.0, 5.0) 返回 15。

True()

函数签名:Bool TRUE()

函数说明:返回布尔值 TRUE。

返回值:返回布尔值 TRUE。

示例: IsDatabaseMailEnabled = True()

Upper()

函数签名:String Upper (String_expression)

函数说明:返回将所有小写字符都转换为大写字符后得到的字符串。

参数:

  • expression - 源字符串表达式。

返回值:所有小写字符均转换为大写字符后返回表示源字符串表达式的字符串。

例如:Len('HeLlO') 返回 'HELLO'。

请参阅

参考

“创建新条件”或“打开条件”对话框,“常规”页

概念

使用基于策略的管理来管理服务器