• Artículo

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

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

Para abrir el cuadro de diálogo Edición avanzada, siga estos pasos:

  1. En el Explorador de objetos, expanda Administración y, a continuación, expanda Administración de directivas.

  2. Realice una de las acciones siguientes:

    • Para crear una nueva condición, haga clic con el botón secundario en Condiciones y, a continuación, haga clic en Nueva condición. O bien, expanda Condiciones, haga clic con el botón secundario en una condición existente y, a continuación, haga clic en Nueva condición.

    • Para modificar una condición existente, expanda Condiciones, haga clic con el botón secundario en la condición que desea modificar y, a continuación, haga clic en Propiedades.

  3. En el área Expresión, haga clic en el botón de puntos suspensivos (...) situado junto a las columnas Campo o Valor. Si es una nueva condición, debe hacer clic dentro de la primera fila del área Expresión para que aparezcan los botones de puntos suspensivos.

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 IN 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.

Nota importanteImportante

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

Función

Descripción

Add()

Firma de la función: Numeric Add (Numeric expression1, Numeric expression2)

Descripción de la función: suma dos números.

Argumentos:

  • expression1 y expression2: es 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 bit. Puede ser una constante, propiedad o función que devuelva un tipo numérico.

Valor devuelto: devuelve el tipo de datos del argumento que tenga mayor prioridad.

Ejemplo:Add(Property1, 5)

Array()

Firma de la función: Array Array (VarArgs expression)

Descripción de la función: crea una matriz a partir de una lista de valores. Se puede utilizar con funciones de agregado como Sum() y Count().

Argumentos:

  • expression: es una expresión que se convertirá en una matriz.

Valor devuelto: la matriz.

Ejemplo:Array(2,3,4,5,6)

Avg()

Firma de la función: Numeric Avg (VarArgs)

Descripción de la función: devuelve el promedio de los valores de la lista de argumentos.

Argumentos:

  • VarArgs: es una lista de expresiones Variant de las categorías de tipos de datos numérico exacto o numérico aproximado, excepto para el tipo de datos bit.

Valor devuelto: el tipo de devuelto está 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.

Ejemplo:Avg(1.0, 2.0, 3.0, 4.0, 5.0) devuelve 3.0 en este ejemplo.

BitwiseAnd()

Firma de la función: Numeric BitwiseAnd (Numeric expression 1, Numeric expression2)

Descripción de la función: lleva a cabo una operación lógica AND bit a bit entre dos valores enteros.

Argumentos:

  • expression1 y expression2: es cualquier expresión válida de cualquiera de los tipos de datos de la categoría de tipos de datos enteros.

Valor devuelto: devuelve un valor de la categoría de tipo de datos entero.

Ejemplo:BitwiseAnd(Property1, Property2)

BitwiseOr()

Firma de la función: Numeric BitwiseOr (Numeric expression1, Numeric expression2)

Descripción de la función: realiza una operación lógica OR bit a bit entre dos valores enteros especificados.

Argumentos:

  • expression1 y expression2: es cualquier expresión válida de cualquiera de los tipos de datos de la categoría de tipos de datos enteros.

Valor devuelto: devuelve un valor de la categoría de tipo de datos entero.

Ejemplo:BitwiseOr(Property1, Property2)

Concatenate()

Firma de la función: String Concatenate (String string1, String string2)

Descripción de la función: concatena dos cadenas.

Argumentos:

  • string1 y string2: son las dos cadenas que se desean concatenar. Puede ser cualquier cadena válida que no sea NULL.

Valor devuelto: la cadena concatenada, con string1 seguida de string2.

Ejemplo:Concatenate("Hello", " World") devuelve "Hello World".

Count()

Firma de la función: Numeric Count (VarArgs)

Descripción de la función: devuelve el número de elementos de la lista de argumentos.

Argumentos:

  • VarArgs: es una expresión de cualquier tipo excepto text, image y ntext.

Valor devuelto: devuelve un valor de la categoría de tipo de datos entero.

Ejemplo:Count(1.0, 2.0, 3.0, 4.0, 5.0) devuelve 5 en este ejemplo.

DateAdd()

Firma de la función: DateTime DateAdd (String datepart, Numeric number, DateTime date)

Descripción de la función: devuelve un nuevo valor datetime que se basa en sumar un intervalo a la fecha especificada.

Argumentos:

  • 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 valor datetime o una cadena de caracteres en formato de fecha.

Valor devuelto: es el valor datetime nuevo que se basa en sumar un intervalo a la fecha especificada.

Ejemplo:DateAdd('day', 21, DateTime('2007-08-06 14:21:50')) devuelve '2007-08-27 14:21:50' en este ejemplo.

En la tabla siguiente se muestran los dateparts y abreviaturas que admite esta función.

Parte de la fechaAbreviaturas
yearyy, yyyy
monthmm, m
dayofyeardy, y
daydd, d
weekwk, ww
weekdaydw, w
hourhh
minutemi, n
secondss, s
millisecondms

DatePart()

Firma de la función: Numeric DatePart (String datepart, DateTime date)

Descripción de la función: devuelve un entero que representa el parámetro datepart especificado de la fecha especificada.

Argumentos:

  • 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 valor datetime o una cadena de caracteres en formato de fecha.

Valor devuelto: devuelve el valor de una categoría de tipo de datos entero que representa el parámetro datepart especificado de la fecha indicada.

Ejemplo:DatePart('month', DateTime('2007-08-06 14:21:50.620')) devuelve 8 en este ejemplo.

DateTime()

Firma de la función: DateTime DateTime (String dateString)

Descripción de la función: crea un valor datetime a partir de una cadena.

Argumentos:

  • dateString: es el valor datetime como una cadena.

Valor devuelto: devuelve un valor datetime creado a partir de la cadena de entrada.

Ejemplo:DateTime('3/12/2006')

Divide()

Firma de la función: Numeric Divide (Numeric expression_dividend, Numeric expression_divisor)

Descripción de la función: divide un número entre otro.

Argumentos:

  • expression_dividend: es la expresión numérica 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.

Valor devuelto: devuelve el tipo de datos del argumento que tenga mayor prioridad.

Ejemplo:Divide(Property1, 2)

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

Firma de la función: Numeric Enum (String enumTypeName, String enumValueName)

Descripción de la función: crea un valor enum a partir de una cadena.

Argumentos:

  • enumTypeName: es el nombre del tipo enum.

  • enumValueName: es el valor enum.

Valor devuelto: devuelve el valor enum como un valor numérico.

Ejemplo:Enum('CompatibilityLevel','Version100')

Escape()

Firma de la función: String Escape (String replaceString, String stringToEscape, String escapeString)

Descripción de la función: antepone a una subcadena de la cadena de entrada una cadena de escape determinada.

Argumentos:

  • 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 desea agregar delante de cada aparición de stringToEscape.

Valor devuelto: devuelve una replaceString modificada en la que escapeString precede a cada aparición de stringToEscape.

Ejemplo:Escape("Hello", "l", "[") devuelve "He[l[lo".

ExecuteSQL()

Firma de la función: Variant ExecuteSQL (String returnType, String sqlQuery)

Descripción de la función: ejecuta la consulta de Transact-SQL con el servidor de destino.

Argumentos:

  • returnType: especifica el tipo de los datos devueltos por la instrucción de Transact-SQL. Los literales válidos para returnType son los siguientes: Numeric, String, Bool, DateTime, Array y Guid.

  • sqlQuery: es la cadena que contiene la consulta que se va a ejecutar.

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

Cuando la función ExecuteSQL está incluida en una condición, None es el único modo de ejecución admitido. Esto significa que la función solo se puede ejecutar como del lado cliente.

Si se proporciona más de una columna, se iniciará una excepción.

La instrucción SELECT puede utilizar las variables siguientes. Estas se sustituirán en tiempo de ejecución mediante la sustitución de parámetros de ADO.NET:

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

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

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

Firma de la función: Variant ExecuteWQL (string returnType , string namespace, string wql)

Descripción de la función: 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.

Argumentos y definición del tipo devuelto

  • 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.

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

False()

Firma de la función: Bool False()

Descripción de la función: devuelve el valor booleano FALSE.

Valor devuelto: devuelve el valor booleano FALSE.

Ejemplo:IsDatabaseMailEnabled = False()

GetDate()

Firma de la función: DateTime GetDate()

Descripción de la función: devuelve la fecha del sistema.

Valor devuelto: devuelve la fecha del sistema como DateTime.

Ejemplo:@DateLastModified = GetDate()

Guid()

Firma de la función: Guid Guid(String guidString)

Descripción de la función: devuelve un GUID a partir de una cadena.

Argumentos:

  • guidString es la representación de cadena del GUID que se va a crear.

Valor devuelto: devuelve el GUID creado a partir de la cadena.

Ejemplo:Guid('12340000-0000-3455-0000-000000000454')

IsNull()

Firma de la función: Variant IsNull (Variant check_expression, Variant replacement_value)

Descripción de la función: se devuelve el valor de check_expression si no es NULL; de lo contrario, se devuelve replacement_value. Si los tipos son diferentes, replacement_value se convierte implícitamente en el tipo de check_expression.

Argumentos:

  • check_expression: es la expresión que se comprueba si es NULL. check_expression puede ser de cualquiera de los tipos admitidos de la 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 al tipo de check_expression.

Valor devuelto: el tipo de check_expression si check_expression no es NULL; de lo contrario, se devuelve el tipo de replacement_value.

Len()

Firma de la función: Numeric Len (string_expression)

Descripción de la función: devuelve el número de caracteres de la expresión de cadena dada, excluidos los espacios en blanco finales.

Argumentos:

  • string_expression: es la expresión de cadena que se va a evaluar.

Valor devuelto: devuelve un valor de la categoría de tipo de datos entero.

Ejemplo:Len('Hello') devuelve 5 en este ejemplo.

Lower()

Firma de la función: String Lower (String_expression)

Descripción de la función: devuelve la cadena después de convertir todos los caracteres en mayúsculas a minúsculas.

Argumentos:

  • expression: es la expresión de la cadena de origen.

Valor devuelto: devuelve una cadena que representa la expresión de la cadena de origen después de convertir todos los caracteres en mayúsculas a minúsculas.

Ejemplo:Len('HeLlO') devuelve 'hello' en este ejemplo.

Mod()

Firma de la función: Numeric Mod (Numeric expression_dividend, Numeric expression_divisor)

Descripción de la función: proporciona el resto entero después de dividir la primera expresión numérica entre la segunda.

Argumentos:

  • expression_dividend: es la expresión numérica 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 entero o numérico.

  • expression_divisor: es la expresión numérica entre 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 tipos de datos entero o numérico.

Valor devuelto: devuelve un valor de la categoría de tipo de datos entero.

Ejemplo:Mod(Property1, 3)

Multiply()

Firma de la función: Numeric Multiply (Numeric expression1, Numeric expression2)

Descripción de la función: Multiplica dos expresiones.

Argumentos:

  • expression1 y expression2: es 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.

Valor devuelto: devuelve el tipo de datos del argumento que tenga mayor prioridad.

Ejemplo:Multiply(Property1, .20)

Power()

Firma de la función: Numeric Power (Numeric numeric_expression, Numeric expression_power)

Descripción de la función: devuelve el valor de la expresión especificada elevado a la potencia indicada.

Argumentos:

  • 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 datos bit.

Valor devuelto: el tipo devuelto es el mismo que el de numeric_expression.

Ejemplo:Power(Property1, 3)

Round()

Firma de la función: Numeric Round (Numeric expression, Numeric expression_precision)

Descripción de la función: Devuelve una expresión numérica redondeada a la longitud o precisión especificadas.

Argumentos:

  • 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_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 se especifica en expression_precision.

Valor devuelto: devuelve el mismo tipo que el de numeric_expression.

Ejemplo:Round(5.333, 0)

String()

Firma de la función: String String (Variant_expression)

Descripción de la función: convierte una expresión variant en una cadena.

Argumentos:

  • expression: es la expresión variant que se va a convertir en una cadena.

Valor devuelto: devuelve el valor de cadena de la expresión variant.

Ejemplo:String(4)

Sum()

Firma de la función: Numeric Sum (VarArgs)

Descripción de la función: devuelve la suma de todos los valores de la lista de argumentos. La suma se puede utilizar con valores numéricos.

Argumentos:

  • VarArgs: es una lista de expresiones Variant de las categorías de tipos de datos numérico exacto o numérico aproximado, excepto para el tipo de datos bit.

Valor devuelto: 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.

Ejemplo:Sum(1.0, 2.0, 3.0, 4.0, 5.0) devuelve 15 en este ejemplo.

True()

Firma de la función: Bool TRUE()

Descripción de la función: devuelve el valor booleano TRUE.

Valor devuelto: devuelve el valor booleano TRUE.

Ejemplo:IsDatabaseMailEnabled = True()

Upper()

Firma de la función: String Upper (String_expression)

Descripción de la función: devuelve la cadena después de convertir todos los caracteres en minúsculas a mayúsculas.

Argumentos:

  • expression: es la expresión de la cadena de origen.

Valor devuelto: devuelve una cadena que representa la expresión de la cadena de origen una vez convertidos en mayúsculas todos los caracteres en minúsculas.

Ejemplo:Len('HeLlO') devuelve 'HELLO' en este ejemplo.