< Back

New-AzureRmLogicApp

Tue Jan 29, 2019 9:51 pm

NAME New-AzureRmLogicApp



SYNOPSIS

Creates a logic app in a resource group.





SYNTAX

New-AzureRmLogicApp [-DefaultProfile <IAzureContextContainer>] [-Definition <Object>] [-IntegrationAccountId <String>] -Location <String> -Name

<String> [-ParameterFilePath <String>] [-Parameters <Object>] -ResourceGroupName <String> [-State {Enabled | Disabled}] [-Confirm] [-WhatIf]

[<CommonParameters>]



New-AzureRmLogicApp [-DefaultProfile <IAzureContextContainer>] [-DefinitionFilePath <String>] [-IntegrationAccountId <String>] -Location <String>

-Name <String> [-ParameterFilePath <String>] [-Parameters <Object>] -ResourceGroupName <String> [-State {Enabled | Disabled}] [-Confirm] [-WhatIf]

[<CommonParameters>]





DESCRIPTION

The New-AzureRmLogicApp cmdlet creates a logic app by using the Logic Apps feature. A logic app is a collection of actions or triggers defined in

Logic App definition. This cmdlet returns a Workflow object.



You can create a logic app by specifying a name, location, Logic App definition, resource group, and plan. A Logic App definition and parameters

are formatted in JavaScript Object Notation (JSON). You can use a logic app as a template for definition and parameters.



This module supports dynamic parameters. To use a dynamic parameter, type it in the command. To discover the names of dynamic parameters, type a

hyphen (-) after the cmdlet name, and then press the Tab key repeatedly to cycle through the available parameters. If you omit a required template

parameter, the cmdlet prompts you for the value. Template parameter file values that you specify at the command line take precedence over template

parameter values in a template parameter object.





PARAMETERS

-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with azure



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Definition <Object>

Specifies the definition for your logic app as an object or a string in JavaScript Object Notataion (JSON) format.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DefinitionFilePath <String>

Specifies the definition of a logic app as the path of a definition file in JSON format.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-IntegrationAccountId <String>

Specifies an integration account ID for the logic app.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Location <String>

Specifies the location of the logic app. Enter an Azure data center location, such as West US or Southeast Asia. You can place a logic app in

any location.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Name <String>

Specifies the name for the logic app.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-ParameterFilePath <String>

Specifies the path of a JSON formatted parameter file.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Parameters <Object>

Specifies a parameters collection object for the Logic App. Specify a hash table, Dictionary<string>, or Dictionary<string, WorkflowParameter>.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-ResourceGroupName <String>

Specifies the name of a resource group.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-State <String>

Specifies the state of the logic app. The acceptable values for this parameter are: Enabled and Disabled.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Shows what would happen if the cmdlet runs. The cmdlet is not run.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None







OUTPUTS

Microsoft.Azure.Management.Logic.Models.Workflow







NOTES









Example 1: Create a logic app by using definition and parameter file paths



PS C:\\>New-AzureRmLogicApp -ResourceGroupName "ResourceGroup11" -Name "LogicApp03" -State "Enabled" -AppServicePlan "ServicePlan01"

-DefinitionFilePath "d:\\workflows\\Definition03.json" -ParameterFilePath "d:\\workflows\\Parameters03.json"

Id :

/subscriptions/57b7034d-72d4-433d-ace2-a7460aed6a99/resourceGroups/LogicAppCmdletTest/providers/Microsoft.Logic/workflows/LogicApp03

Name : LogicApp03

Type : Microsoft.Logic/workflows

Location : westus

ChangedTime : 1/13/2016 2:41:39 PM

CreatedTime : 1/13/2016 2:41:39 PM

AccessEndpoint : https://westus.logic.azure.com:443/subs ... rceGroup1/

providers/Microsoft.Logic/workflows/LogicApp1

State : Enabled

DefinitionLinkUri :

DefinitionLinkContentVersion :

Definition : {$schema, contentVersion, parameters, triggers...}

ParametersLinkUri :

ParametersLinkContentVersion :

Parameters : {[destinationUri, Microsoft.Azure.Management.Logic.Models.WorkflowParameter]}

SkuName : Standard

PlanName : ServicePlan01

PlanType : Microsoft.Web/ServerFarms

PlanId :

/subscriptions/57b7034d-72d4-433d-ace2-a7460aed6a99/resourceGroups/ResourceGroup11/providers/Microsoft.Web/serverfarms/ServicePlan1

Version : 08587489107859952120



This command creates a logic app in the specified resource group. The logic app includes the definition and parameters specified by file paths.





Example 2: Create a logic app by using definition and parameter objects



PS C:\\>New-AzureRmLogicApp -ResourceGroupName "ResourceGroup11" -Name "LogicApp05" -Location "westus" -State "Enabled" -AppServicePlan

"ServicePlan01" -Definition [IO.File]::ReadAllText("d:\\Workflows\\Definition.json") -Parameters @{name1="value1", name2="value2"}

Id :

/subscriptions/57b7034d-72d4-433d-ace2-a7460aed6a99/resourceGroups/LogicAppCmdletTest/providers/Microsoft.Logic/workflows/LogicApp05

Name : LogicApp05

Type : Microsoft.Logic/workflows

Location : westus

ChangedTime : 1/13/2016 2:41:39 PM

CreatedTime : 1/13/2016 2:41:39 PM

AccessEndpoint : https://westus.logic.azure.com:443/subs ... rceGroup11

/providers/Microsoft.Logic/workflows/LogicApp05

State : Enabled

DefinitionLinkUri :

DefinitionLinkContentVersion :

Definition : {$schema, contentVersion, parameters, triggers...}

ParametersLinkUri :

ParametersLinkContentVersion :

Parameters : {[destinationUri, Microsoft.Azure.Management.Logic.Models.WorkflowParameter]}

SkuName : Standard

PlanName : ServicePlan1

PlanType : Microsoft.Web/ServerFarms

PlanId :

/subscriptions/57b7034d-72d4-433d-ace2-a7460aed6a99/resourceGroups/ResourceGroup11/providers/Microsoft.Web/serverfarms/ServicePlan1

Version : 08587489107859952120



This command creates a logic app in the specified resource group resource group.





Example 3: Create a logic app by using the pipeline to specify the resource group



PS C:\\>Get-AzureRmResourceGroup -ResourceGroupName "ResourceGroup11" | New-AzureRmLogicApp -Name "LogicApp11" -State "Enabled" -AppServicePlan

"ServicePlan01" -DefinitionFilePath "d:\\Workflow\\Definition.json" -ParameterFilePath "d:\\Workflow\\Parameters.json"

Id :

/subscriptions/57b7034d-72d4-433d-ace2-a7460aed6a99/resourceGroups/LogicAppCmdletTest/providers/Microsoft.Logic/workflows/LogicApp11

Name : LogicApp11

Type : Microsoft.Logic/workflows

Location : westus

ChangedTime : 1/13/2016 2:41:39 PM

CreatedTime : 1/13/2016 2:41:39 PM

AccessEndpoint : https://westus.logic.azure.com:443/subs ... rceGroup11

/providers/Microsoft.Logic/workflows/LogicApp11

State : Enabled

DefinitionLinkUri :

DefinitionLinkContentVersion :

Definition : {$schema, contentVersion, parameters, triggers...}

ParametersLinkUri :

ParametersLinkContentVersion :

Parameters : {[destinationUri, Microsoft.Azure.Management.Logic.Models.WorkflowParameter]}

SkuName : Standard

PlanName : ServicePlan01

PlanType : Microsoft.Web/ServerFarms

PlanId :

/subscriptions/57b7034d-72d4-433d-ace2-a7460aed6a99/resourceGroups/ResourceGroup11/providers/Microsoft.Web/serverfarms/ServicePlan01

Version : 08587489107859952120



This command gets the resource group named ResourceGroup11 by using the Get-AzureRmResourceGroup cmdlet. The command passes that resource group to

the current cmdlet by using the pipeline operator. The current cmdlet creates a logic app in that resource group. The logic app includes the

definition and parameters specified by file paths.





Example 4: Create a logic app based on an existing logic app



PS C:\\>$Workflow = Get-AzureRmLogicApp -ResourceGroupName "ResourceGroup11" -Name "LogicApp03"

PS C:\\> New-AzureRmLogicApp -ResourceGroupName "ResourceGroup11" -Name "LogicApp13" -State "Enabled" -AppServicePlan "ServicePlan01" -Definition

$Workflow.Definition -Parameters $Workflow.Parameters

Id :

/subscriptions/57b7034d-72d4-433d-ace2-a7460aed6a99/resourceGroups/LogicAppCmdletTest/providers/Microsoft.Logic/workflows/LogicApp13

Name : LogicApp13

Type : Microsoft.Logic/workflows

Location : westus

ChangedTime : 1/13/2016 2:41:39 PM

CreatedTime : 1/13/2016 2:41:39 PM

AccessEndpoint : https://westus.logic.azure.com:443/subs ... rceGroup11

/providers/Microsoft.Logic/workflows/LogicApp13

State : Enabled

DefinitionLinkUri :

DefinitionLinkContentVersion :

Definition : {$schema, contentVersion, parameters, triggers...}

ParametersLinkUri :

ParametersLinkContentVersion :

Parameters : {[destinationUri, Microsoft.Azure.Management.Logic.Models.WorkflowParameter]}

SkuName : Standard

PlanName : ServicePlan01

PlanType : Microsoft.Web/ServerFarms

PlanId :

/subscriptions/57b7034d-72d4-433d-ace2-a7460aed6a99/resourceGroups/ResourceGroup11/providers/Microsoft.Web/serverfarms/ServicePlan01

Version : 08587489107859952120



The first command gets the logic app named LogicApp03 by using the Get-AzureRmLogicApp cmdlet. The command stores the logic app in the $Workflow

variable.



The second command creates a new logic app that uses the definition and parameters of the logic app stored in $Workflow.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... rmlogicapp

Get-AzureRmLogicApp

Remove-AzureRmLogicApp

Set-AzureRmLogicApp

Start-AzureRmLogicApp