Compartilhar via


Caixa de diálogo Edição Avançada (Condição)

Use a caixa de diálogo Edição Avançada para criar expressões complexas para condições de Gerenciamento Baseado em Políticas.

Opções

  • Valor da célula
    Exibe a função ou a expressão que será usada para o valor de célula quando você o criar. Quando você clicar em OK, o valor da célula aparecerá na célula Campo ou Valor na caixa de expressão da condição da caixa de diálogo Criar Nova Condição ou Abrir Condição na página Geral.

  • Funções e propriedades
    Exibe as funções e propriedades disponíveis.

  • Detalhes
    Exibe informações sobre as funções e propriedades nos formatos assinatura de função, descrição de função, valor de retorno e exemplo.

Sintaxe

Expressões válidas devem estar no seguinte formato:

{property | function | constant}

{operator}

{property | function | constant}

Exemplos

Alguns exemplos de expressões válidas incluem:

  • Property1 > 5

  • Property1 = Property2

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

  • Sometext IN Property1

  • Property1 < Fn(Property2)

  • BitwiseAnd(Property1, Property2) = 0

Informações adicionais da função

A seção a seguir fornece informações adicionais sobre as funções que você pode usar para criar expressões complexas para condições de Gerenciamento Baseado em Políticas.

Observação importanteImportante

As funções que você pode usar para criar condições de Gerenciamento Baseado em Políticas nem sempre usam a sintaxe Transact-SQL. Não se esqueça de seguir a sintaxe de exemplo. Por exemplo, quando usar as funções DateAdd ou DatePart, você deverá colocar o argumento datepart entre aspas simples.

Função

Descrição

Add()

Assinatura de função: Numeric Add (Numeric expression1, Numeric expression2)

Descrição da função: adiciona dois números.

Argumentos:

  • expression1 e expression2 - é qualquer expressão válida de qualquer um dos tipos de dados na categoria numérica, com exceção do tipo de dados bit. Pode ser uma constante, propriedade ou função que retorna um tipo numérico.

Valor de retorno: retorna o tipo de dados do argumento que tem a maior precedência.

Exemplo: Add(Property1, 5)

Array()

Assinatura de função: Array Array (VarArgs expression)

Descrição da função: cria uma matriz com base em uma lista de valores. Pode ser usado com funções de agregação como Sum() e Count().

Argumentos:

  • expression- é uma expressão que será convertida em uma matriz.

Valor de retorno: a matriz.

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

Avg()

Assinatura de função: Numeric Avg (VarArgs)

Descrição da função: retorna a média de todos os valores na lista de argumentos.

Argumentos:

  • VarArgs - é uma lista de expressões variantes da categoria de tipo de dados numéricos aproximados ou exatos, com exceção do tipo de dados bit.

Valor de retorno: o tipo de retorno é determinado pelo tipo de resultado avaliado da expressão.

Se o resultado da expressão forem as categorias integer, decimal, money, smallmoney, float e real, os tipos de retorno serão int, decimal, money e float, respectivamente.

Exemplo: Avg(1.0, 2.0, 3.0, 4.0, 5.0) retorna 3.0 neste exemplo.

BitwiseAnd()

Assinatura de função: Numeric BitwiseAnd (Numeric expression 1, Numeric expression2)

Descrição de função: executa uma operação AND lógica bit a bit entre dois valores inteiros.

Argumentos:

  • expression1 e expression2 - é qualquer expressão válida de qualquer um dos tipos de dados da categoria de tipo de dados inteiros.

Valor de retorno: retorna um valor de categoria de tipo de dados inteiros.

Exemplo: BitwiseAnd(Property1, Property2)

BitwiseOr()

Assinatura de função: Numeric BitwiseOr (Numeric expression1, Numeric expression2)

Descrição de função: executa uma operação OR lógica bit a bit entre dois valores inteiros especificados.

Argumentos:

  • expression1 e expression2 - é qualquer expressão válida de qualquer um dos tipos de dados da categoria de tipo de dados inteiros.

Valor de retorno: retorna um valor de categoria de tipo de dados inteiros.

Exemplo: BitwiseOr(Property1, Property2)

Concatenate()

Assinatura de função: String Concatenate (String string1, String string2)

Descrição da função: concatena duas cadeias de caracteres.

Argumentos:

  • string1 e string2 - são as duas cadeias de caracteres que você deseja concatenar. Pode ser qualquer cadeia não nula válida.

Valor de retorno: a cadeia de caracteres concatenada, com string1 seguida por string2.

Exemplo: Concatenate("Hello", " World") retorna "Hello World".

Count()

Assinatura de função: Numeric Count (VarArgs)

Descrição da função: retorna o número de itens na lista de argumentos.

Argumentos:

  • VarArgs - é uma expressão de qualquer tipo, com exceção de text, image e ntext.

Valor de retorno: retorna um valor de categoria de tipo de dados inteiros.

Exemplo: Count(1.0, 2.0, 3.0, 4.0, 5.0) retorna 5 neste exemplo.

DateAdd()

Assinatura de função: DateTime DateAdd (String datepart, Numeric number, DateTime date)

Descrição de função: retorna um valor datetime novo com base na adição de um intervalo à data especificada.

Argumentos:

  • datepart - é o parâmetro que especifica em qual parte da data retornar um valor novo. Alguns dos tipos com suporte são year(yy, yyyy), month(mm., m) e dayofyear(dy, y). Para obter mais informações, consulte DATEADD (Transact-SQL).

  • number - é o valor usado para incrementar datepart.

  • date - é uma expressão que retorna um valor datetime ou uma cadeia de caracteres em um formato de data.

Valor de retorno: é o novo valor datetime com base na adição de um intervalo à data especificada.

Exemplo: DateAdd('day', 21, DateTime('2007-08-06 14:21:50')) retorna '2007-08-27 14:21:50' neste exemplo.

A tabela a seguir lista o dateparts e as abreviações que são aceitas por esta função.

Parte da data

Abreviações

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

Assinatura de função: Numeric DatePart (String datepart, DateTime date)

Descrição de função: retorna um inteiro que representa o datepart especificado da data especificada.

Argumentos:

  • datepart - é o parâmetro que especifica a parte da data para retornar. Alguns dos tipos com suporte são year(yy, yyyy), month(mm., m) e dayofyear(dy, y). Para obter mais informações, consulte DATEPART (Transact-SQL).

  • date - é uma expressão que retorna um valor datetime ou uma cadeia de caracteres em um formato de data.

Valor de retorno: retorna o valor da categoria de tipo de dados inteiros que representa a datepart especificada da data especificada.

Exemplo: DatePart('month', DateTime('2007-08-06 14:21:50.620')) retorna 8 neste exemplo.

DateTime()

Assinatura de função: DateTime DateTime (String dateString)

Descrição da função: cria um valor datetime com base em uma cadeia de caracteres.

Argumentos:

  • dateString- é o valor datetime como uma cadeia de caracteres.

Valor de retorno: retorna um valor datatime criado a partir da cadeia de caracteres de entrada.

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

Divide()

Assinatura de função: Numeric Divide (Numeric expression_dividend, Numeric expression_divisor)

Descrição da função: divide um número por outro.

Argumentos:

  • expression_dividend- é a expressão numérica a ser dividida. O dividendo pode ser qualquer expressão válida para qualquer um dos tipos de dados da categoria de tipo de dados numéricos, com exceção do tipo de dados datetime.

  • expression_divisor - é a expressão numérica pela qual dividir o dividendo. O divisor pode ser qualquer expressão válida para qualquer um dos tipos de dados da categoria de tipo de dados numéricos, com exceção do tipo de dados datetime.

Valor de retorno: retorna o tipo de dados do argumento que tem a maior precedência.

Exemplo: Divide(Property1, 2)

ObservaçãoObservação

Esta será uma operação dupla. Para fazer uma comparação de inteiro, você deve combinar os resultados com Round(). Por exemplo: Round(Divide(10, 3), 0) = 3.

Enum()

Assinatura de função: Numeric Enum (String enumTypeName, String enumValueName)

Descrição da função: cria um valor enum com base em uma cadeia de caracteres.

Argumentos:

  • enumTypeName - é o nome do tipo de enum.

  • enumValueName - é o valor de enum.

Valor de retorno: retorna o valor de enum como um valor numérico.

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

Escape()

Assinatura de função: String Escape (String replaceString, String stringToEscape, String escapeString)

Descrição da função: ignora uma subcadeia da cadeia de entrada com uma determinada cadeia de caracteres de escape.

Argumentos:

  • replaceString – é a cadeia de entrada.

  • stringToEscape – é uma subcadeia de replaceString. Esta é a cadeia em frente à qual você deseja adicionar uma cadeia de escape.

  • escapeString – é a cadeia de escape que você deseja adicionar na frente de cada instância de stringToEscape.

Valor de retorno: retorna uma replaceString modificada na qual cada instância de stringToEscape é precedida por escapeString.

Exemplo: Escape("Hello", "l", "[") retorna "He[l[lo".

ExecuteSQL()

Assinatura de função: Variant ExecuteSQL (String returnType, String sqlQuery)

Descrição de função: executa a consulta Transact-SQL no servidor de destino.

Argumentos:

  • returnType - especifica o tipo de retorno dos dados retornados pela instrução Transact-SQL. Os literais válidos para returnType são os seguintes: Numeric, String, Bool, DateTime, Array e Guid.

  • sqlQuery - é a cadeia de caracteres que contém a consulta a ser executada.

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

Executa uma consulta de Transact-SQL com valor escalar em uma instância de destino do SQL Server. Só uma coluna pode ser especificada em uma instrução SELECT; são ignoradas colunas adicionais além da primeira. A consulta resultante deveria retornar só uma linha; são ignoradas linhas adicionais além da primeira. Se a consulta retornar um conjunto vazio, a expressão de condição compilada com base no ExecuteSQL será avaliada como falsa. ExecuteSql oferece suporte aos modos de avaliação Sob demanda e Ao agendar.

  • @@ObjectName - corresponde ao campo de nome em sys.objects. A variável será substituída pelo nome do objeto atual.

  • @@ObjectSchema - corresponde ao campo de nome em sys.schemas. A variável será substituída pelo nome do esquema para o objeto atual, se aplicável.

ObservaçãoObservação

Para incluir uma aspa simples em uma instrução ExecuteSQL, utilize uma segunda aspa simples. Por exemplo, para incluir uma referência a um usuário nomeado O'Brian, digite O"Brian.

ExecuteWQL()

Assinatura de função: Variant ExecuteWQL (string returnType , string namespace, string wql)

Descrição de função: executa o script WQL no namespace que é fornecido. A instrução de seleção pode conter apenas uma única coluna de retorno. Se mais de uma coluna for fornecida, um erro será gerado.

Argumentos e definição de tipo de retorno

  • returnType - especifica o tipo de retorno de dados que é retornado pelo WQL. As literais válidas são Numeric, String, Bool, DateTime, Array e Guid.

  • namespace - é o namespace WMI para executar.

  • wql - é a cadeia de caracteres que contém o WQL a ser executado.

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

False()

Assinatura de função: Bool False()

Descrição da função: retorna o valor booliano FALSE.

Valor de retorno: retorna um valor booliano FALSE.

Exemplo: IsDatabaseMailEnabled = False()

GetDate()

Assinatura de função: DateTime GetDate()

Descrição da função: retorna a data de sistema.

Valor de retorno: retorna a data de sistema como DateTime.

Exemplo: @DateLastModified = GetDate()

Guid()

Assinatura de função: Guid Guid(String guidString)

Descrição da função: retorna um GUID de uma cadeia de caracteres.

Argumentos:

  • guidString- é a representação de cadeia de caracteres do GUID a ser criado.

Valor de retorno: retorna o GUID criado a partir da cadeia de caracteres.

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

IsNull()

Assinatura de função: Variant IsNull (Variant check_expression, Variant replacement_value)

Descrição da função: o valor de check_expression será retornado se não for NULL; caso contrário, replacement_value será retornado. Se os tipos forem diferentes, replacement_value será convertido implicitamente no tipo de check_expression.

Argumentos:

  • check_expression - É a expressão a ser verificada para NULL. check_expression pode ser qualquer um dos tipos de Gerenciamento Baseado em Políticas com suporte: Numeric, String, Bool, DateTime, Array e Guid.

  • replacement_value - É a expressão a ser retornada se check_expression for NULL. replacement_value deve ser de um tipo de dados implicitamente convertido no tipo de check_expression.

Valor de retorno: o tipo de retorno é o tipo de check_expression se check_expression não for NULL; caso contrário, o tipo de replacement_value será retornado.

Len()

Assinatura de função: Numeric Len (string_expression)

Descrição da função: retorna o número de caracteres da expressão da cadeia de caracteres fornecida, excluindo espaços em branco à direita.

Argumentos:

  • string_expression - é a expressão da cadeia de caracteres a ser avaliada.

Valor de retorno: retorna um valor de categoria de tipo de dados inteiros.

Exemplo: Len('Hello') retorna 5 neste exemplo.

Lower()

Assinatura de função: String Lower (String_expression)

Descrição da função: retorna a cadeia de caracteres depois de converter todos os caracteres maiúsculos em minúsculos.

Argumentos:

  • expression- É a expressão de cadeia de caracteres de origem.

Valor de retorno: retorna uma cadeia de caracteres que representa a expressão da cadeia de caracteres de origem depois de converter todos os caracteres maiúsculos em minúsculos.

Exemplo: Len('HeLlO') retorna 'hello' neste exemplo.

Mod()

Assinatura de função: Numeric Mod (Numeric expression_dividend, Numeric expression_divisor)

Descrição da função: - fornece o restante de valores inteiros após a divisão da primeira expressão numérica pela segunda.

Argumentos:

  • expression_dividend- é a expressão numérica a ser dividida. expression_dividend deve ser qualquer expressão válida de qualquer um dos tipos de dados nas categorias de tipos de dados inteiros ou numéricos.

  • expression_divisor - É a expressão numérica pela qual dividir o dividendo. expression_divisor deve ser qualquer expressão válida de qualquer um dos tipos de dados nas categorias de tipos de dados inteiros ou numéricos.

Valor de retorno: retorna um valor de categoria de tipo de dados inteiros.

Exemplo: Mod(Property1, 3)

Multiply()

Assinatura de função: Numeric Multiply (Numeric expression1, Numeric expression2)

Descrição de função: multiplica duas expressões.

Argumentos:

  • expression1 e expression2 - é qualquer expressão válida de qualquer um dos tipos de dados na categoria numérica, com exceção do tipo de dados datetime.

Valor de retorno: retorna o tipo de dados do argumento que tem a maior precedência.

Exemplo: Multiply(Property1, .20)

Power()

Assinatura de função: Numeric Power (Numeric numeric_expression, Numeric expression_power)

Descrição da função: retornar o valor da expressão especificada para a potência especificada.

Argumentos:

  • numeric_expression - é uma expressão da categoria de tipo de dados numéricos exatos ou aproximados, com exceção do tipo de dados bit.

  • expression_power - É a potência à qual elevar numeric_expression. expression_power pode ser uma expressão da categoria de tipo de dados numéricos exatos ou aproximados, com exceção do tipo de dados bit.

Valor de retorno: tipo de retorno é mesmo que para numeric_expression.

Exemplo: Power(Property1, 3)

Round()

Assinatura de função: Numeric Round (Numeric expression, Numeric expression_precision)

Descrição da função: retorna uma expressão numérica arredondada ao comprimento ou à precisão especificada.

Argumentos:

  • expression - é uma expressão da categoria de tipo de dados numéricos exatos ou aproximados, com exceção do tipo de dados bit.

  • expression_precision - é a precisão para a qual a expressão deve ser arredondada. Quando expression_precision for um número positivo, numeric_expression será arredondada para o número de posições decimais especificado pelo comprimento. Quando expression_precision for um número negativo, numeric_expression será arredondada no lado esquerdo do ponto decimal, conforme especificado por expression_precision.

Valor de retorno: retorna o mesmo tipo que numeric_expression.

Exemplo: Round(5.333, 0)

String()

Assinatura de função: String String (Variant_expression)

Descrição da função: converte uma variável em uma cadeia de caracteres.

Argumentos:

  • expression- é a expressão variante a ser convertida em uma cadeia de caracteres.

Valor de retorno: retorna o valor da cadeia de caracteres da expressão variável.

Exemplo: String(4)

Sum()

Assinatura de função: Numeric Sum (VarArgs)

Descrição da função: retorna a soma de todos os valores na lista de argumentos. Sum pode ser usada com valores numéricos.

Argumentos:

  • VarArgs - é uma lista de expressões variantes da categoria de tipo de dados numéricos aproximados ou exatos, com exceção do tipo de dados bit.

Valor de retorno: retorna a adição de todos os valores da expressão no tipo de dados de expressão mais preciso.

Se o resultado da expressão forem as categorias integer, numeric, money, small money, float e real, os tipos de retorno serão int, numeric, money e float, respectivamente.

Exemplo: Sum(1.0, 2.0, 3.0, 4.0, 5.0) retorna 15 neste exemplo.

True()

Assinatura de função: Bool TRUE()

Descrição da função: retorna o valor booliano TRUE.

Valor de retorno: retorna um valor booliano TRUE.

Exemplo: IsDatabaseMailEnabled = True()

Upper()

Assinatura de função: String Upper (String_expression)

Descrição da função: retorna a cadeia de caracteres depois de converter todos os caracteres minúsculos em maiúsculos.

Argumentos:

  • expression- é a expressão de cadeia de caracteres de origem.

Valor de retorno: retorna uma cadeia de caracteres que representa a expressão da cadeia de caracteres de origem depois de converter todos os caracteres minúsculos em maiúsculos.

Exemplo: Len('HeLlO') retorna 'HELLO' neste exemplo.

Consulte também

Referência

Caixa de diálogo Criar Nova Condição ou Abrir Condição, Página Geral

Conceitos

Administrar servidores com Gerenciamento Baseado em Políticas