Share via


Cuadro de diálogo Edición avanzada (condición)

Use el cuadro de diálogo Edición avanzada para crear expresiones complejas para las condiciones de administración basada en directivas.

Opciones

Valor de celda
Muestra la función o expresión que se utilizará para el valor de celda al crearlo. Al hacer clic en Aceptar, el valor de celda aparecerá en la celda Campo o Valor en el cuadro de expresión de condición del cuadro de diálogo Crear nueva condición o Abrir condición en la página General .

Funciones y propiedades
Muestra las funciones y propiedades disponibles.

Detalles
Muestra la información sobre las funciones y propiedades, con el formato: firma de la función, descripción de la función, valor devuelto y ejemplo.

Sintaxis

Las expresiones válidas deben estar en el formato siguiente:

{property | function | constant}

{operator}

{property | function | constant}

Ejemplos

A continuación se muestran algunos ejemplos de expresiones válidas:

  • Property1> 5

  • Property1=Property2

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

  • Sometext EN Property1

  • Property1< Fn(Property2)

  • BitwiseAnd(Property1,Property2)= 0

Información adicional de funciones

En las secciones siguientes se proporciona información adicional sobre las funciones que puede utilizar con el fin de crear expresiones complejas para las condiciones de administración basada en directivas.

Importante

Las funciones que puede usar para crear condiciones de administración basada en directivas no siempre usan la sintaxis de Transact-SQL. Asegúrese de seguir la sintaxis del ejemplo. Por ejemplo, al usar las DateAdd funciones o DatePart , debe incluir el argumento datepart entre comillas simples.

Función Descripción Argumentos Valor devuelto Ejemplo
Add() Numeric Add (Numeric expression1, Numeric expression2)

Suma dos números.
expression1 y expression2 : es cualquier expresión válida de cualquiera de los tipos de datos de la categoría numérica, excepto el bit tipo de datos. Puede ser una constante, propiedad o función que devuelva un tipo numérico. Valor devuelto: Devuelve el tipo de datos del argumento que tiene mayor prioridad. Ejemplo:Add(Property1, 5)
Array() Array Array (VarArgs expression)

Crea una matriz a partir de una lista de valores. Se puede utilizar con funciones de agregado como Sum() y Count().
expression : es una expresión que se convertirá en una matriz. Matriz. Array(2,3,4,5,6)
Avg() Numeric Avg (VarArgs)

devuelve el promedio de valores de la lista de argumentos.
VarArgs : es la lista de expresiones Variant de la categoría de tipo de datos numérico exacto o numérico aproximado, excepto para el tipo de bit datos. El tipo de valor devuelto viene determinado por el tipo del resultado evaluado de la expresión.

Si el resultado de la expresión es de la categoría integer, decimal, money o smallmoney, o de la categoría float o real, los tipos devueltos son int, decimal, money y float; respectivamente.
Avg(1.0, 2.0, 3.0, 4.0, 5.0) devuelve 3.0 en este ejemplo.
BitwiseAnd() Numeric BitwiseAnd (Numeric expression 1, Numeric expression2)

Realiza una operación lógica AND bit a bit entre dos valores enteros.
expression1 y expression2 : es cualquier expresión válida de cualquiera de los tipos de datos de la categoría de tipo de datos entero. Devuelve un valor de categoría con el tipo de datos integer. BitwiseAnd(Property1, Property2)
BitwiseOr() Numeric BitwiseOr (Numeric expression1, Numeric expression2)

Realiza una operación lógica OR bit a bit entre dos valores enteros especificados.
expression1 y expression2 : es cualquier expresión válida de cualquiera de los tipos de datos de la categoría de tipo de datos entero. Devuelve un valor de categoría con el tipo de datos integer. BitwiseOr(Property1, Property2)
Concatenate() String Concatenate (String string1, String string2)

Concatena dos cadenas.
string1 y string2 : son las dos cadenas que se quiere concatenar. Puede ser cualquier cadena válida que no sea NULL. La cadena concatenada, con string1 seguida de string2. Concatenate("Hello", " World") devuelve "Hello World".
Count() Numeric Count (VarArgs)

Devuelve el número de elementos en la lista de argumentos.
VarArgs : es una expresión de cualquier tipo excepto text, imagey ntext. Devuelve un valor de categoría con el tipo de datos integer. Count(1.0, 2.0, 3.0, 4.0, 5.0) devuelve 5 en este ejemplo.
DateAdd() DateTime DateAdd (String datepart, Numeric number, DateTime date)

Devuelve un valor datetime nuevo que se basa en sumar un intervalo a la fecha especificada.
datepart : es el parámetro que especifica en qué parte de la fecha se devuelve un valor nuevo. Algunos de los tipos admitidos son year(yy, yyyy), month(mm, m) y dayofyear(dy, y). Para obtener más información, vea DATEADD (Transact-SQL).

number: es el valor que se usa para incrementar datepart.

date : es una expresión que devuelve un datetime valor o una cadena de caracteres en un formato de fecha.
Es el valor datetime nuevo que se basa en sumar un intervalo a la fecha especificada. DateAdd('day', 21, DateTime('2007-08-06 14:21:50')) devuelve '2007-08-27 14:21:50' en este ejemplo.

A continuación se enumeran los pares dateparts y abreviaturas admitidos por esta función:

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)

Devuelve un entero que representa el datepart especificado de la fecha especificada.
datepart : es el parámetro que especifica la parte de la fecha que se devolverá. Algunos de los tipos admitidos son year(yy, yyyy), month(mm, m) y dayofyear(dy, y). Para obtener más información, vea DATEPART (Transact-SQL).

date : es una expresión que devuelve un datetime valor o una cadena de caracteres en un formato de fecha.
Devuelve el valor de una categoría de tipo de datos entero que representa el parámetro datepart especificado de la fecha indicada. DatePart('month', DateTime('2007-08-06 14:21:50.620')) devuelve 8 en este ejemplo.
DateTime() DateTime DateTime (String dateString)

Crea un valor datetime a partir de una cadena.
dateString : es el valor datetime como una cadena. Devuelve un valor datetime creado a partir de la cadena de entrada. DateTime('3/12/2006')
Divide() Numeric Divide (Numeric expression_dividend, Numeric expression_divisor)

Divide un número por otro.
expression_dividend : es la expresión numérica entre la que se va a dividir. El dividendo puede ser cualquier expresión válida de cualquiera de los tipos de datos de la categoría de tipos de datos numéricos, excepto el tipo de datos datetime.

expression_divisor : es la expresión numérica entre la que se divide el dividendo. El divisor puede ser cualquier expresión válida de cualquiera de los tipos de datos de la categoría de tipos de datos numéricos, excepto el tipo de datos datetime.
Devuelve el tipo de datos del argumento que tenga mayor prioridad. Divide(Property1, 2)

Nota: será una operación de valores double. Para hacer una comparación de valores enteros, debe combinar los resultados con Round(). Por ejemplo: Round(Divide(10, 3), 0) = 3.
Enum() Numeric Enum (String enumTypeName, String enumValueName)

Crea un valor enum a partir de una cadena.
enumTypeName : es el nombre del tipo enum.

enumValueName : es el valor de la enumeración.
Devuelve el valor enum como un valor numérico. Enum('CompatibilityLevel','Version100')
Escape() String Escape (String replaceString, String stringToEscape, String escapeString)

Antepone a una subcadena de la cadena de entrada una cadena de escape determinada.
replaceString: es la cadena de entrada.

stringToEscape: es una subcadena de replaceString. Se trata de la cadena a la que desea anteponer una cadena de escape.

escapeString: es la cadena de escape que quiere agregar delante de cada instancia de stringToEscape.
Devuelve una replaceString modificada en la que cada instancia de stringToEscape es precedida por escapeString. Escape("Hello", "l", "[") devuelve "He[l[lo".
ExecuteSQL() Variant ExecuteSQL (String returnType, String sqlQuery)

Ejecuta la consulta de Transact-SQL en el servidor de destino.

Para obtener más información sobre ExecuteSql(), vea el tema sobre la función ExecuteSql().
returnType : especifica el tipo de valor devuelto de datos devueltos por la instrucción Transact-SQL. Los literales válidos para returnType son los siguientes: Numeric, , StringBool, DateTime, Arrayy Guid.

sqlQuery : es la cadena que contiene la consulta que se va a ejecutar.
ExecuteSQL ('Numeric', 'SELECT COUNT(*) FROM msdb.dbo.sysjobs') <> 0

Ejecuta una consulta de Transact-SQL con valores escalares en una instancia de destino de SQL Server. Solo se puede especificar una columna en una instrucción SELECT ; se omiten las columnas posteriores a la primera. La consulta resultante debe devolver solo una fila; se omiten las filas posteriores a la primera. Si la consulta devuelve un conjunto vacío, la expresión de condición creada en torno a ExecuteSQL se evaluará como FALSE. ExecuteSql admite los modos de evaluación A petición y Al programar .

@@ObjectName : corresponde al campo de nombre de sys.objects. La variable será reemplazada por el nombre del objeto actual.

@@SchemaName : corresponde al campo de nombre de sys.schemas. La variable será reemplazada por el nombre del esquema para el objeto actual, si es aplicable.



Nota: para incluir una comilla simple en una instrucción ExecuteSQL, defina la comilla simple como carácter de escape mediante dos comillas simples. Por ejemplo, para incluir una referencia a un usuario cuyo nombre es O'Brian, escriba O"Brian.
ExecuteWQL() Variant ExecuteWQL (string returnType , string namespace, string wql)

Ejecuta el script WQL con el espacio de nombres que se proporciona. La instrucción Select puede contener solo una única columna de retorno. Si se proporciona más de una columna, se producirá un error.
returnType : especifica el tipo de datos devuelto por WQL. Los literales válidos son Numeric, String, Bool, DateTime, Array y Guid.

namespace : es el espacio de nombres de WMI con el que se realiza la ejecución.

wql : es la cadena que contiene el lenguaje WQL que se va a ejecutar.
ExecuteWQL('Numeric', 'root\CIMV2', 'select NumberOfProcessors from win32_ComputerSystem') <> 0
False() Bool False()

Devuelve el valor booleano FALSE.
Devuelve el valor booleano FALSE. IsDatabaseMailEnabled = False()
GetDate() DateTime GetDate()

Devuelve la fecha del sistema.
Devuelve la fecha del sistema como DateTime. @DateLastModified = GetDate()
Guid() Guid Guid(String guidString)

Devuelve un GUID a partir de una cadena.
guidString : es la representación de cadena del GUID que se va a crear. Devuelve el GUID creado a partir de la cadena. Guid('12340000-0000-3455-0000-000000000454')
IsNull() Variant IsNull (Variant check_expression, Variant replacement_value)

Se devuelve el valor de check_expression si no es NULL; en caso contrario, se devuelve replacement_value . Si los tipos son diferentes, replacement_value se convierte implícitamente en el tipo de check_expression.
check_expression : es la expresión que se va a comprobar si es NULL. check_expression : puede ser de cualquier tipo compatible de administración basada en directivas: Numeric, String, Bool, DateTime, Array y Guid.

replacement_value : es la expresión que se devuelve si check_expression es NULL. replacement_value debe ser de un tipo que se convierta implícitamente en el tipo de check_expression.
Se devuelve el tipo de check_expression si check_expression no es NULL; de lo contrario, se devuelve el tipo de replacement_value .
Len() Numeric Len (string_expression)

Devuelve el número de caracteres de la expresión de cadena dada, excluyendo los espacios en blanco del final.
string_expression : es la expresión de cadena que se va a evaluar. Devuelve un valor de categoría con el tipo de datos integer. Len('Hello') devuelve 5 en este ejemplo.
Lower() Cadena inferior (String*_expression*)

Devuelve la cadena después de convertir todos los caracteres en mayúscula a minúscula.
expression : es la expresión de la cadena de origen. Devuelve una cadena que representa la expresión de cadena de origen después de haber convertido todos los caracteres en mayúscula a minúscula. Len('HeLlO') devuelve 'hello' en este ejemplo.
Mod() Numeric Mod (Numeric expression_dividend, Numeric expression_divisor)

Proporciona el resto entero después de dividir la primera expresión numérica por la segunda expresión numérica.
expression_dividend : es la expresión numérica entre la que se va a dividir. expression_dividend debe ser una expresión válida de cualquiera de los tipos de datos de las categorías de tipos de datos enteros y numéricos.

expression_divisor : es la expresión numérica por la que se va a dividir el dividendo. expression_divisor debe ser cualquier expresión válida de cualquiera de los tipos de datos de las categorías de tipo de datos entero o numérico.
Devuelve un valor de categoría con el tipo de datos integer. Mod(Property1, 3)
Multiply() Numeric Multiply (Numeric expression1, Numeric expression2)

Multiplica dos expresiones.
expression1 y expression2 : es cualquier expresión válida de cualquiera de los tipos de datos de la categoría numérica, excepto el datetime tipo de datos. Devuelve el tipo de datos del argumento que tenga mayor prioridad. Multiply(Property1, .20)
Power() Numeric Power (Numeric numeric_expression, Numeric expression_power)

Devuelve el valor de la expresión especificada a la potencia especificada.
numeric_expression : es una expresión de la categoría de tipos de datos numérico exacto o numérico aproximado, excepto para el tipo de datos bit.

expression_power : es la potencia a la que se eleva numeric_expression. expression_power puede ser una expresión de la categoría de tipo de datos numérico exacto o numérico aproximado, excepto para el tipo de bit datos.
El tipo devuelto es el mismo de numeric_expression. Power(Property1, 3)
Round() Numeric Round (Numeric expression, Numeric expression_precision)

Devuelve una expresión numérica, redondeada a la longitud o precisión especificada.
expresión : es una expresión de la categoría de tipo de datos numérico exacto o numérico aproximado, excepto para el tipo de bit datos.

expression_precision : es la precisión con la que se redondea la expresión. Si expression_precision es un número positivo, numeric_expression se redondea al número de posiciones decimales especificado por la longitud. Si expression_precision es un número negativo, numeric_expression se redondea a la izquierda del separador decimal, según lo especificado por expression_precision.
Devuelve el mismo tipo que numeric_expression. Round(5.333, 0)
String() Cadena de cadena (Variant*_expression*)

Convierte una variante en una cadena.
expression : es la expresión variant que se va a convertir en una cadena. Devuelve el valor de cadena de la expresión variant. String(4)
Sum() Numeric Sum (VarArgs)

Devuelve la suma de todos los valores de una lista de argumentos. La suma se puede utilizar con valores numéricos.
VarArgs: es una lista de la expresión Variant de la categoría de tipo de datos numérico exacto o numérico aproximado, excepto para el bit tipo de datos. Devuelve la suma de todos los valores de expresión en el tipo de datos de expresión más preciso.

Si el resultado de la expresión es de la categoría integer, numeric, money o small money, o de la categoría float o real, los tipos devueltos son int, numeric, money y float; respectivamente.
Sum(1.0, 2.0, 3.0, 4.0, 5.0) devuelve 15 en este ejemplo.
True() Bool TRUE()

Devuelve el valor booleano TRUE.
Devuelve el valor booleano TRUE. IsDatabaseMailEnabled = True()
Upper() String Upper (String*_expression*)

Devuelve la cadena después de convertir todos los caracteres en minúscula a mayúscula.
expression : es la expresión de la cadena de origen. Devuelve una cadena que representa la expresión de cadena de origen después de convertir todos los caracteres en minúscula a mayúscula. Len('HeLlO') devuelve 'HELLO' en este ejemplo.

Consulte también

Cuadro de diálogo Crear nueva condición o Abrir condición, página General
Administrar servidores mediante administración basada en directivas