Logische functies voor Azure Resource Manager sjablonenLogical functions for Azure Resource Manager templates

Resource Manager biedt verschillende functies voor het maken van vergelijkingen in uw sjablonen.Resource Manager provides several functions for making comparisons in your templates.

enand

and(arg1, arg2, ...)

Controleert of alle parameter waarden waar zijn.Checks whether all parameter values are true.

ParametersParameters

ParameterParameter VereistRequired TypeType BeschrijvingDescription
arg1arg1 JaYes booleaansboolean De eerste waarde om te controleren of deze waar is.The first value to check whether is true.
Arg2arg2 JaYes booleaansboolean De tweede waarde om te controleren of waar is.The second value to check whether is true.
aanvullende argumentenadditional arguments NeeNo booleaansboolean Aanvullende argumenten om te controleren of deze waar zijn.Additional arguments to check whether are true.

RetourwaardeReturn value

Retourneert waar als alle waarden waar zijn. anders False.Returns True if all values are true; otherwise, False.

VoorbeeldenExamples

In de volgende voorbeeld sjabloon ziet u hoe u logische functies gebruikt.The following example template shows how to use logical functions.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [ ],
    "outputs": {
        "andExampleOutput": {
            "value": "[and(bool('true'), bool('false'))]",
            "type": "bool"
        },
        "orExampleOutput": {
            "value": "[or(bool('true'), bool('false'))]",
            "type": "bool"
        },
        "notExampleOutput": {
            "value": "[not(bool('true'))]",
            "type": "bool"
        }
    }
}

De uitvoer van het vorige voor beeld is:The output from the preceding example is:

NaamName TypeType WaardeValue
andExampleOutputandExampleOutput BoolBool FalseFalse
orExampleOutputorExampleOutput BoolBool TrueTrue
notExampleOutputnotExampleOutput BoolBool FalseFalse

boolbool

bool(arg1)

Zet de para meter om in een Boole-waarde.Converts the parameter to a boolean.

ParametersParameters

ParameterParameter VereistRequired TypeType BeschrijvingDescription
arg1arg1 JaYes teken reeks of intstring or int De waarde die moet worden geconverteerd naar een Boole.The value to convert to a boolean.

RetourwaardeReturn value

Een Boolean van de geconverteerde waarde.A boolean of the converted value.

VoorbeeldenExamples

In de volgende voorbeeld sjabloon ziet u hoe u BOOL gebruikt met een teken reeks of een geheel getal.The following example template shows how to use bool with a string or integer.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [],
    "outputs": {
        "trueString": {
            "value": "[bool('true')]",
            "type" : "bool"
        },
        "falseString": {
            "value": "[bool('false')]",
            "type" : "bool"
        },
        "trueInt": {
            "value": "[bool(1)]",
            "type" : "bool"
        },
        "falseInt": {
            "value": "[bool(0)]",
            "type" : "bool"
        }
    }
}

De uitvoer uit het vorige voorbeeld met de standaardwaarden is:The output from the preceding example with the default values is:

NaamName TypeType WaardeValue
trueStringtrueString BoolBool TrueTrue
falseStringfalseString BoolBool FalseFalse
trueInttrueInt BoolBool TrueTrue
falseIntfalseInt BoolBool FalseFalse

ifif

if(condition, trueValue, falseValue)

Retourneert een waarde op basis van het feit of een voor waarde waar of onwaar is.Returns a value based on whether a condition is true or false.

ParametersParameters

ParameterParameter VereistRequired TypeType BeschrijvingDescription
conditioncondition JaYes booleaansboolean De waarde om te controleren of deze True of False is.The value to check whether it's true or false.
trueValuetrueValue JaYes teken reeks, int, object of matrixstring, int, object, or array De waarde die moet worden geretourneerd als de voor waarde waar is.The value to return when the condition is true.
falseValuefalseValue JaYes teken reeks, int, object of matrixstring, int, object, or array De waarde die moet worden geretourneerd als de voor waarde ONWAAR is.The value to return when the condition is false.

RetourwaardeReturn value

Retourneert een tweede para meter wanneer de eerste para meter Trueis; anders retourneert de derde para meter.Returns second parameter when first parameter is True; otherwise, returns third parameter.

OpmerkingenRemarks

Als de voor waarde waaris, wordt alleen de waarde True geëvalueerd.When the condition is True, only the true value is evaluated. Als de voor waarde Onwaaris, wordt alleen de waarde ONWAAR geëvalueerd.When the condition is False, only the false value is evaluated. Met de functie als kunt u expressies toevoegen die alleen voorwaarde geldig zijn.With the if function, you can include expressions that are only conditionally valid. U kunt bijvoorbeeld verwijzen naar een resource die zich onder één voor waarde bevindt, maar niet onder de andere voor waarde.For example, you can reference a resource that exists under one condition but not under the other condition. In de volgende sectie ziet u een voor beeld van een conditioneel evalueren van expressies.An example of conditionally evaluating expressions is shown in the following section.

VoorbeeldenExamples

In de volgende voorbeeld sjabloon ziet u hoe u de if functie gebruikt.The following example template shows how to use the if function.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
    ],
    "outputs": {
        "yesOutput": {
            "type": "string",
            "value": "[if(equals('a', 'a'), 'yes', 'no')]"
        },
        "noOutput": {
            "type": "string",
            "value": "[if(equals('a', 'b'), 'yes', 'no')]"
        },
        "objectOutput": {
            "type": "object",
            "value": "[if(equals('a', 'a'), json('{\"test\": \"value1\"}'), json('null'))]"
        }
    }
}

De uitvoer van het vorige voor beeld is:The output from the preceding example is:

NaamName TypeType WaardeValue
yesOutputyesOutput TekenreeksString jayes
geen uitvoernoOutput TekenreeksString neeno
objectOutputobjectOutput ObjectObject {"test": "waarde1"}{ "test": "value1" }

In de volgende voorbeeld sjabloon ziet u hoe u deze functie kunt gebruiken met expressies die alleen voorwaarde geldig zijn.The following example template shows how to use this function with expressions that are only conditionally valid.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "vmName": {
            "type": "string"
        },
        "location": {
            "type": "string"
        },
        "logAnalytics": {
            "type": "string",
            "defaultValue": ""
        }
    },
    "resources": [
        {
            "condition": "[not(empty(parameters('logAnalytics')))]",
            "name": "[concat(parameters('vmName'),'/omsOnboarding')]",
            "type": "Microsoft.Compute/virtualMachines/extensions",
            "location": "[parameters('location')]",
            "apiVersion": "2017-03-30",
            "properties": {
                "publisher": "Microsoft.EnterpriseCloud.Monitoring",
                "type": "MicrosoftMonitoringAgent",
                "typeHandlerVersion": "1.0",
                "autoUpgradeMinorVersion": true,
                "settings": {
                    "workspaceId": "[if(not(empty(parameters('logAnalytics'))), reference(parameters('logAnalytics'), '2015-11-01-preview').customerId, json('null'))]"
                },
                "protectedSettings": {
                    "workspaceKey": "[if(not(empty(parameters('logAnalytics'))), listKeys(parameters('logAnalytics'), '2015-11-01-preview').primarySharedKey, json('null'))]"
                }
            }
        }
    ],
    "outputs": {
        "mgmtStatus": {
            "type": "string",
            "value": "[if(not(empty(parameters('logAnalytics'))), 'Enabled monitoring for VM!', 'Nothing to enable')]"
        }
    }
}

notnot

not(arg1)

Zet Boole-waarde om in tegenovergestelde waarde.Converts boolean value to its opposite value.

ParametersParameters

ParameterParameter VereistRequired TypeType BeschrijvingDescription
arg1arg1 JaYes booleaansboolean De waarde die moet worden geconverteerd.The value to convert.

RetourwaardeReturn value

Retourneert waar als de para meter Falseis.Returns True when parameter is False. Retourneert Onwaar wanneer de para meter Trueis.Returns False when parameter is True.

VoorbeeldenExamples

In de volgende voorbeeld sjabloon ziet u hoe u logische functies gebruikt.The following example template shows how to use logical functions.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [ ],
    "outputs": {
        "andExampleOutput": {
            "value": "[and(bool('true'), bool('false'))]",
            "type": "bool"
        },
        "orExampleOutput": {
            "value": "[or(bool('true'), bool('false'))]",
            "type": "bool"
        },
        "notExampleOutput": {
            "value": "[not(bool('true'))]",
            "type": "bool"
        }
    }
}

De uitvoer van het vorige voor beeld is:The output from the preceding example is:

NaamName TypeType WaardeValue
andExampleOutputandExampleOutput BoolBool FalseFalse
orExampleOutputorExampleOutput BoolBool TrueTrue
notExampleOutputnotExampleOutput BoolBool FalseFalse

De volgende voorbeeld sjabloon gebruikt niet met gelijk aan.The following example template uses not with equals.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
    ],
    "outputs": {
        "checkNotEquals": {
            "type": "bool",
            "value": "[not(equals(1, 2))]"
        }
    }

De uitvoer van het vorige voor beeld is:The output from the preceding example is:

NaamName TypeType WaardeValue
checkNotEqualscheckNotEquals BoolBool TrueTrue

ofor

or(arg1, arg2, ...)

Controleert of een parameter waarde waar is.Checks whether any parameter value is true.

ParametersParameters

ParameterParameter VereistRequired TypeType BeschrijvingDescription
arg1arg1 JaYes booleaansboolean De eerste waarde om te controleren of deze waar is.The first value to check whether is true.
Arg2arg2 JaYes booleaansboolean De tweede waarde om te controleren of waar is.The second value to check whether is true.
aanvullende argumentenadditional arguments NeeNo booleaansboolean Aanvullende argumenten om te controleren of deze waar zijn.Additional arguments to check whether are true.

RetourwaardeReturn value

Retourneert waar als een wille keurige waarde waar is; anders False.Returns True if any value is true; otherwise, False.

VoorbeeldenExamples

In de volgende voorbeeld sjabloon ziet u hoe u logische functies gebruikt.The following example template shows how to use logical functions.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [ ],
    "outputs": {
        "andExampleOutput": {
            "value": "[and(bool('true'), bool('false'))]",
            "type": "bool"
        },
        "orExampleOutput": {
            "value": "[or(bool('true'), bool('false'))]",
            "type": "bool"
        },
        "notExampleOutput": {
            "value": "[not(bool('true'))]",
            "type": "bool"
        }
    }
}

De uitvoer van het vorige voor beeld is:The output from the preceding example is:

NaamName TypeType WaardeValue
andExampleOutputandExampleOutput BoolBool FalseFalse
orExampleOutputorExampleOutput BoolBool TrueTrue
notExampleOutputnotExampleOutput BoolBool FalseFalse

Volgende stappenNext steps