Freigeben über


Dialogfeld 'Erweiterte Bearbeitung (Bedingung)'

Verwenden Sie das Dialogfeld Erweiterte Bearbeitung, um komplexe Ausdrücke für richtlinienbasierte Verwaltungsbedingungen zu erstellen.

Optionen

  • Zellenwert
    Zeigt die Funktion oder den Ausdruck an, die bzw. der als Zellenwert verwendet wird, wenn Sie ihn erstellen. Wenn Sie auf OK klicken, wird der Zellenwert in der Zelle Feld oder Wert im Bedingungsausdrucksfeld des Dialogfelds Neue Bedingung erstellen oder Bedingung öffnen auf der Seite Allgemein angezeigt.

  • Funktionen und Eigenschaften
    Zeigt die verfügbaren Funktionen und Eigenschaften an.

  • Details
    Zeigt die Informationen über die Funktionen und Eigenschaften in folgendem Format an: Funktionssignatur, Funktionsbeschreibung, Rückgabewert und Beispiel.

Syntax

Gültige Ausdrücke müssen in folgendem Format vorliegen:

{property | function | constant}

{operator}

{property | function | constant}

Beispiele

Einige Beispiele für gültige Ausdrücke sind:

  • Property1 > 5

  • Property1 = Property2

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

  • Sometext IN Property1

  • Property1 < Fn(Property2)

  • BitwiseAnd(Property1, Property2) = 0

Zusätzliche Funktionsinformationen

Die folgenden Abschnitte enthalten zusätzliche Informationen über die Funktionen, die Sie verwenden können, um komplexe Ausdrücke für richtlinienbasierte Verwaltungsbedingungen zu erstellen.

Wichtiger HinweisWichtig

Für die Funktionen, mit denen Sie richtlinienbasierte Verwaltungsbedingungen erstellen können, wird nicht immer die Transact-SQL-Syntax verwendet. Stellen Sie sicher, dass Sie die Beispielsyntax befolgen. Wenn Sie beispielsweise die DateAdd-Funktion oder die DatePart-Funktion verwenden, müssen Sie das datepart-Argument in einfache Anführungszeichen einschließen.

Funktion

Beschreibung

Add()

Funktionssignatur: Numeric Add (Numeric expression1, Numeric expression2)

Funktionsbeschreibung: Addiert zwei Zahlen.

Argumente:

  • expression1 und expression2 - Ein beliebiger gültiger Ausdruck eines der Datentypen in der numerischen Datentypkategorie, mit Ausnahme des bit-Datentyps. Kann eine Konstante, Eigenschaft oder Funktion sein, die einen numerischen Typ zurückgibt.

Rückgabewert: Gibt den Datentyp des Arguments zurück, das in der Rangfolge höher eingestuft ist.

Beispiel: Add(Property1, 5)

Array()

Funktionssignatur: Array Array (VarArgs expression)

Funktionsbeschreibung: Erstellt ein Array aus einer Liste von Werten. Kann mit Aggregatfunktionen, wie z. B. Sum() und Count(), verwendet werden.

Argumente:

  • expression – Ein Ausdruck, der in ein Array konvertiert wird.

Rückgabewert: Das Array.

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

Avg()

Funktionssignatur: Numeric Avg (VarArgs)

Funktionsbeschreibung: Gibt den Durchschnitt der Werte in der Argumentliste zurück.

Argumente:

  • VarArgs - Ist eine Liste des Variant-Ausdrucks der genauen numerischen oder ungefähren numerischen Datentypkategorie, mit Ausnahme des bit-Datentyps.

Rückgabewert: Der Rückgabetyp wird durch den Typ des ausgewerteten Ergebnisses des Ausdrucks bestimmt.

Wenn das Ausdrucksergebnis integer, decimal, money und smallmoney, float ist und der real-Kategorie angehört, sind die Rückgabetypen int, decimal, money oder float.

Beispiel: Avg(1.0, 2.0, 3.0, 4.0, 5.0) gibt in diesem Beispiel 3.0 zurück.

BitwiseAnd()

Funktionssignatur: Numeric BitwiseAnd (Numeric expression 1, Numeric expression2)

Funktionsbeschreibung: Führt eine bitweise logische AND-Operation zwischen zwei ganzzahligen Werten aus.

Argumente:

  • expression1 und expression2 - Ein beliebiger gültiger Ausdruck eines der Datentypen der ganzzahligen Datentypkategorie.

Rückgabewert: Gibt einen Wert der ganzzahligen Datentypkategorie zurück.

Beispiel: BitwiseAnd(Property1, Property2)

BitwiseOr()

Funktionssignatur: Numeric BitwiseOr (Numeric expression1, Numeric expression2)

Funktionsbeschreibung: Führt eine bitweise logische OR-Operation zwischen zwei angegebenen ganzzahligen Werten aus.

Argumente:

  • expression1 und expression2 - Ein beliebiger gültiger Ausdruck eines der Datentypen der ganzzahligen Datentypkategorie.

Rückgabewert: Gibt einen Wert der ganzzahligen Datentypkategorie zurück.

Beispiel: BitwiseOr(Property1, Property2)

Concatenate()

Funktionssignatur: String Concatenate (String string1, String string2)

Funktionsbeschreibung: Verkettet zwei Zeichenfolgen.

Argumente:

  • string1 und string2 – Dies sind die beiden Zeichenfolgen, die Sie verketten möchten. Dabei kann es sich um jede gültige Zeichenfolge ungleich NULL handeln.

Rückgabewert: Die verkettete Zeichenfolge mit string1 gefolgt von string2.

Beispiel: Concatenate("Hello", " World") gibt Folgendes zurück: "Hello World".

Count()

Funktionssignatur: Numeric Count (VarArgs)

Funktionsbeschreibung: Gibt die Anzahl der Elemente in der Argumentliste zurück.

Argumente:

  • VarArgs - Ein Ausdruck eines beliebigen Typs, mit Ausnahme von text, image und ntext.

Rückgabewert: Gibt einen Wert der ganzzahligen Datentypkategorie zurück.

Beispiel: Count(1.0, 2.0, 3.0, 4.0, 5.0) gibt in diesem Beispiel 5 zurück.

DateAdd()

Funktionssignatur: DateTime DateAdd (String datepart, Numeric number, DateTime date)

Funktionsbeschreibung: Gibt einen neuen datetime-Wert zurück, der auf dem Hinzufügen eines Intervalls zum angegebenen Datum basiert.

Argumente:

  • datepart - Der Parameter, der angibt, für welchen Teil des Datums ein neuer Wert zurückgegeben werden soll. Einige der unterstützten Typen sind year(yy, yyyy), month(mm, m) und dayofyear (dy, y). Weitere Informationen finden Sie unter DATEADD (Transact-SQL).

  • number - Der Wert, der zum Inkrementieren von datepart verwendet wird.

  • date - Ein Ausdruck, der einen datetime-Wert oder eine Zeichenfolge in einem Datumsformat zurückgibt.

Rückgabewert: Der neue datetime-Wert, der auf dem Hinzufügen eines Intervalls zum angegebenen Datum basiert.

Beispiel: DateAdd('day', 21, DateTime('2007-08-06 14:21:50')) gibt in diesem Beispiel '2007-08-27 14:21:50' zurück.

In der folgenden Tabelle sind die dateparts und Abkürzungen aufgeführt, die von dieser Funktion unterstützt werden.

Datumseinheit

Abkürzungen

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

Funktionssignatur: Numeric DatePart (String datepart, DateTime date)

Funktionsbeschreibung: Gibt eine ganze Zahl zurück, die den angegebenen datepart-Wert des angegebenen Datums darstellt.

Argumente:

  • datepart - Der Parameter, der angibt, welche Datumseinheit zurückgegeben werden soll. Einige der unterstützten Typen sind year(yy, yyyy), month(mm, m) und dayofyear (dy, y). Weitere Informationen finden Sie unter DATEPART (Transact-SQL).

  • date - Ein Ausdruck, der einen datetime-Wert oder eine Zeichenfolge in einem Datumsformat zurückgibt.

Rückgabewert: Gibt einen Wert der ganzzahligen Datentypkategorie zurück, der den angegebenen datepart-Wert des angegebenen Datums darstellt.

Beispiel: DatePart('month', DateTime('2007-08-06 14:21:50.620')) gibt in diesem Beispiel 8 zurück.

DateTime()

Funktionssignatur: DateTime DateTime (String dateString)

Funktionsbeschreibung: Erstellt einen datetime-Wert aus einer Zeichenfolge.

Argumente:

  • dateString - Der datetime-Wert als Zeichenfolge.

Rückgabewert: Gibt einen aus der Eingabezeichenfolge erstellten datatime-Wert zurück.

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

Divide()

Funktionssignatur: Numeric Divide (Numeric expression_dividend, Numeric expression_divisor)

Funktionsbeschreibung: Dividiert eine Zahl durch eine andere.

Argumente:

  • expression_dividend- Der zu dividierende numerische Ausdruck. Der Dividend kann jeder gültige Ausdruck von einem Datentyp aus der numerischen Datentypkategorie sein, mit Ausnahme des datetime-Datentyps.

  • expression_divisor - Der numerische Ausdruck, durch den der Dividend geteilt werden soll. Der Divisor kann jeder gültige Ausdruck von einem Datentyp aus der numerischen Datentypkategorie sein, mit Ausnahme des datetime-Datentyps.

Rückgabewert: Gibt den Datentyp des Arguments zurück, das in der Rangfolge höher eingestuft ist.

Beispiel: Divide(Property1, 2)

HinweisHinweis

Dies ist ein doppelter Vorgang. Um einen Vergleich mit ganzzahligen Werten vorzunehmen, müssen Sie die Ergebnisse mit Round() kombinieren. Beispiel: Round(Divide(10, 3), 0) = 3.

Enum()

Funktionssignatur: Numeric Enum (String enumTypeName, String enumValueName)

Funktionsbeschreibung: Erstellt einen enum-Wert aus einer Zeichenfolge.

Argumente:

  • enumTypeName – Der Name des enum-Typs.

  • enumValueName – Der Wert von enum.

Rückgabewert: Gibt den Enumerationswert als numerischen Wert zurück.

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

Escape()

Funktionssignatur: String Escape (String replaceString, String stringToEscape, String escapeString)

Funktionsbeschreibung: Versieht eine Teilzeichenfolge der Eingabezeichenfolge mit einer bestimmten Escapezeichenfolge.

Argumente:

  • replaceString – Die Eingabezeichenfolge.

  • stringToEscape – Teilzeichenfolge von replaceString. Dies ist die Zeichenfolge, vor der Sie eine Escapezeichenfolge hinzufügen möchten.

  • escapeString – Die Escapezeichenfolge, die Sie vor jeder Instanz von stringToEscape hinzufügen möchten.

Rückgabewert: Gibt eine geänderte Version von replaceString zurück, wobei jeder Instanz von stringToEscape jeweils escapeString vorangestellt wird.

Beispiel: Escape("Hello", "l", "[") gibt Folgendes zurück: "He[l[lo".

ExecuteSQL()

Funktionssignatur: Variant ExecuteSQL (String returnType, String sqlQuery)

Funktionsbeschreibung: Führt die Transact-SQL-Abfrage für den Zielserver aus.

Argumente:

  • returnType - Gibt den Rückgabetyp der durch die Transact-SQL-Anweisung zurückgegebenen Daten an. Die gültigen Literale für returnType sind: Numeric, String, Bool, DateTime, Array und Guid.

  • sqlQuery - Die Zeichenfolge, die die auszuführende Abfrage enthält.

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

Führt eine Transact-SQL-Skalarwertabfrage für eine Zielinstanz von SQL Server aus. In einer SELECT-Anweisung kann nur eine Spalte angegeben werden. Zusätzliche Spalten nach der ersten Spalte werden ignoriert. Die resultierende Abfrage sollte nur eine Zeile zurückgeben. Zusätzliche Zeilen nach der ersten Zeile werden ignoriert. Wenn die Abfrage eine leere Menge zurückgibt, wird der für ExecuteSQL erstellte Bedingungsausdruck zu false ausgewertet. ExecuteSql unterstützt die Auswertungsmodi Bedarfsgesteuert und Nach Zeitplan.

  • @@ObjectName - Entspricht dem Namensfeld in sys.objects. Die Variable wird durch den Namen des aktuellen Objekts ersetzt.

  • @@ObjectSchema - Entspricht dem Namensfeld in sys.schemas. Die Variable wird durch den Namen des Schemas für das aktuelle Objekt ersetzt, sofern zutreffend.

HinweisHinweis

Um ein einfaches Anführungszeichen in einer ExecuteSQL-Anweisung aufzunehmen, kennzeichnen Sie das einfache Anführungszeichen mit einem weiteren einfachen Anführungszeichen. Um beispielsweise einen Verweis auf einen Benutzer mit dem Namen O'Brian einzuschließen, geben Sie O"Brian ein.

ExecuteWQL()

Funktionssignatur: Variant ExecuteWQL (string returnType , string namespace, string wql)

Funktionsbeschreibung: Führt das WQL-Skript für den bereitgestellten Namespace aus. Die Select-Anweisung kann nur eine Rückgabespalte enthalten. Wenn mehr als eine Spalte bereitgestellt wird, wird ein Fehler ausgelöst.

Argumente und Rückgabetypdefinition

  • returnType - Gibt den Rückgabetyp der durch die WQL-Abfrage zurückgegebenen Daten an. Die gültigen Literale sind Numeric, String, Bool, DateTime, Array und Guid.

  • namespace- Der WMI-Namespace für die Ausführung.

  • wql - Ist die Zeichenfolge, die die auszuführende WQL-Abfrage enthält.

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

False()

Funktionssignatur: Bool False()

Funktionsbeschreibung: Gibt den booleschen Wert FALSE zurück.

Rückgabewert: Gibt den booleschen Wert FALSE zurück.

Beispiel: IsDatabaseMailEnabled = False()

GetDate()

Funktionssignatur: DateTime GetDate()

Funktionsbeschreibung: Gibt das Systemdatum zurück.

Rückgabewert: Gibt das Systemdatum als datetime-Wert zurück.

Beispiel: @DateLastModified = GetDate()

Guid()

Funktionssignatur: Guid Guid(String guidString)

Funktionsbeschreibung: Gibt eine GUID aus einer Zeichenfolge zurück.

Argumente:

  • guidString - Die Zeichenfolgendarstellung der zu erstellenden GUI.

Rückgabewert: Gibt die GUID zurück, die aus der Zeichenfolge erstellt wurde.

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

IsNull()

Funktionssignatur: Variant IsNull (Variant check_expression, Variant replacement_value)

Funktionsbeschreibung: Der Wert von check_expression wird zurückgegeben, wenn der Wert nicht NULL ist. Andernfalls wird replacement_value zurückgegeben. Sind die Typen unterschiedlich, wird replacement_value implizit in den Typ check_expression konvertiert.

Argumente:

  • check_expression - Ist der Ausdruck, der auf NULL überprüft werden soll. check_expression kann ein beliebiger von der richtlinienbasierten Verwaltung unterstützter Typ sein: Numeric, String, Bool, DateTime, Array und Guid.

  • replacement_value - Ist der Ausdruck, der zurückgegeben werden soll, wenn check_expression NULL ist. Der Typ von replacement_value muss implizit in den Typ von check_expression konvertiert werden können.

Rückgabewert: Der Rückgabetyp ist vom Typ check_expression, wenn check_expression nicht NULL ist. Andernfalls wird der Typ replacement_value zurückgegeben.

Len()

Funktionssignatur: Numeric Len (string_expression)

Funktionsbeschreibung: Gibt die Anzahl von Zeichen im angegebenen Zeichenfolgenausdruck zurück, wobei nachfolgende Leerzeichen ausgeschlossen werden.

Argumente:

  • string_expression - Der auszuwertende Zeichenfolgenausdruck.

Rückgabewert: Gibt einen Wert der ganzzahligen Datentypkategorie zurück.

Beispiel: Len('Hello') gibt in diesem Beispiel 5 zurück.

Lower()

Funktionssignatur: String Lower (String_expression)

Funktionsbeschreibung: Gibt die Zeichenfolge zurück, nachdem alle Großbuchstaben in Kleinbuchstaben konvertiert wurden.

Argumente:

  • expression - Der Quellzeichenfolgen-Ausdruck.

Rückgabewert: Gibt eine Zeichenfolge zurück, die den Quellzeichenfolgen-Ausdruck darstellt, nachdem alle Großbuchstaben in Kleinbuchstaben konvertiert wurden.

Beispiel: Len('HeLlO') gibt in diesem Beispiel 'hello' zurück.

Mod()

Funktionssignatur: Numeric Mod (Numeric expression_dividend, Numeric expression_divisor)

Funktionsbeschreibung: Stellt den ganzzahligen Rest einer Division des ersten numerischen Ausdrucks durch den zweiten bereit.

Argumente:

  • expression_dividend- Der zu dividierende numerische Ausdruck. expression_dividend muss ein gültiger Ausdruck eines Datentyps aus den Datentypkategorien für ganze Zahlen oder numerische Werte sein.

  • expression_divisor - Ist der numerische Ausdruck, durch den der Dividend geteilt werden soll. expression_divisor muss ein gültiger Ausdruck eines Datentyps aus den Datentypkategorien für ganze Zahlen oder numerische Werte sein.

Rückgabewert: Gibt einen Wert der ganzzahligen Datentypkategorie zurück.

Beispiel: Mod(Property1, 3)

Multiply()

Funktionssignatur: Numeric Multiply (Numeric expression1, Numeric expression2)

Funktionsbeschreibung: Multipliziert zwei Ausdrücke.

Argumente:

  • expression1 und expression2 - Ein beliebiger gültiger Ausdruck eines der Datentypen in der numerischen Datentypkategorie, mit Ausnahme des datetime-Datentyps.

Rückgabewert: Gibt den Datentyp des Arguments zurück, das in der Rangfolge höher eingestuft ist.

Beispiel: Multiply(Property1, .20)

Power()

Funktionssignatur: Numeric Power (Numeric numeric_expression, Numeric expression_power)

Funktionsbeschreibung: Gibt den Wert des angegebenen numerischen Ausdrucks in der angegebenen Potenz zurück.

Argumente:

  • numeric_expression - Ein Ausdruck der genauen numerischen oder ungefähren numerischen Datentypkategorie, mit Ausnahme des Bit-Datentyps.

  • expression_power – Dies ist die Potenz, in die numeric_expression erhoben werden soll. expression_power kann ein Ausdruck mit einem Datentyp aus der genauen numerischen oder der ungefähren numerischen Datentypkategorie sein, mit Ausnahme des bit-Datentyps.

Rückgabewert: Der Rückgabetyp ist identisch mit numeric_expression.

Beispiel: Power(Property1, 3)

Round()

Funktionssignatur: Numeric Round (Numeric expression, Numeric expression_precision)

Funktionsbeschreibung: Gibt einen numerischen Ausdruck zurück, der auf die angegebene Länge oder Genauigkeit gerundet wurde.

Argumente:

  • expression - Ein Ausdruck der genauen numerischen oder ungefähren numerischen Datentypkategorie, mit Ausnahme des bit-Datentyps.

  • expression_precision - Die Genauigkeit, auf die der Ausdruck gerundet wird. Wenn expression_precision eine positive Zahl ist, wird numeric_expression auf die Anzahl der durch length angegebenen Dezimalstellen gerundet. Wenn expression_precision eine negative Zahl ist, wird numeric_expression auf der linken Seite des Dezimaltrennzeichens gemäß der Angabe von expression_precision gerundet.

Rückgabewert: Gibt denselben Typ zurück wie numeric_expression.

Beispiel: Round(5.333, 0)

String()

Funktionssignatur: String String (Variant_expression)

Funktionsbeschreibung: Konvertiert eine Variante in eine Zeichenfolge.

Argumente:

  • expression - Der Variantenausdruck, der zu einer Zeichenfolge konvertiert werden soll.

Rückgabewert: Gibt den Zeichenfolgenwert des Variant-Ausdrucks zurück.

Beispiel: String(4)

Sum()

Funktionssignatur: Numeric Sum (VarArgs)

Funktionsbeschreibung: Gibt die Summe aller Werte in der Argumentliste zurück. Sum kann mit numerischen Werten verwendet werden.

Argumente:

  • VarArgs - Eine Liste des Variant-Ausdrucks der genauen numerischen oder ungefähren numerischen Datentypkategorie, mit Ausnahme des bit-Datentyps.

Rückgabewert: Gibt die Summe aller Ausdruckswerte im genauesten Ausdrucksdatentyp zurück.

Wenn das Ausdrucksergebnis integer, numeric, money und small money, float ist und der real-Kategorie angehört, ist der Rückgabetyp int, numeric, money oder float.

Beispiel: Sum(1.0, 2.0, 3.0, 4.0, 5.0) gibt in diesem Beispiel 15 zurück.

True()

Funktionssignatur: Bool TRUE()

Funktionsbeschreibung: Gibt den booleschen Wert TRUE zurück.

Rückgabewert: Gibt den booleschen Wert TRUE zurück.

Beispiel: IsDatabaseMailEnabled = True()

Upper()

Funktionssignatur: String Upper (String_expression)

Funktionsbeschreibung: Gibt die Zeichenfolge zurück, nachdem alle Kleinbuchstaben in Großbuchstaben konvertiert wurden.

Argumente:

  • expression - Der Quellzeichenfolgen-Ausdruck.

Rückgabewert: Gibt eine Zeichenfolge zurück, die den Quellzeichenfolgen-Ausdruck darstellt, nachdem alle Kleinbuchstaben in Großbuchstaben konvertiert wurden.

Beispiel: Len('HeLlO') gibt in diesem Beispiel 'HELLO' zurück.

Siehe auch

Verweis

Dialogfeld 'Neue Bedingung erstellen' oder 'Bedingung öffnen', Seite 'Allgemein'

Konzepte

Verwalten von Servern mit der richtlinienbasierten Verwaltung