New-AzureRmLogicApp
リソース グループにロジック アプリを作成します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
New-AzureRmLogicApp
-ResourceGroupName <String>
-Name <String>
-Location <String>
[-State <String>]
-Definition <Object>
[-IntegrationAccountId <String>]
[-Parameters <Object>]
[-ParameterFilePath <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmLogicApp
-ResourceGroupName <String>
-Name <String>
-Location <String>
[-State <String>]
-DefinitionFilePath <String>
[-IntegrationAccountId <String>]
[-Parameters <Object>]
[-ParameterFilePath <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
New-AzureRmLogicApp コマンドレットは、Logic Apps 機能を使用してロジック アプリを作成します。 ロジック アプリは、ロジック アプリ定義で定義されているアクションまたはトリガーのコレクションです。 このコマンドレットは、Workflow オブジェクトを返します。 ロジック アプリを作成するには、名前、場所、ロジック アプリ定義、リソース グループ、プランを指定します。 ロジック アプリの定義とパラメーターは、JavaScript Object Notation (JSON) で書式設定されます。 ロジック アプリは、定義とパラメーターのテンプレートとして使用できます。 このモジュールでは、動的パラメーターがサポートされています。 動的パラメーターを使用するには、コマンドに入力します。 動的パラメーターの名前を検出するには、コマンドレット名の後にハイフン (-) を入力し、Tab キーを繰り返し押して、使用可能なパラメーターを順番に移動します。 必要なテンプレート パラメーターを省略すると、コマンドレットによって値の入力が求められます。 コマンド ラインで指定したテンプレート パラメーター ファイルの値は、テンプレート パラメーター オブジェクトのテンプレート パラメーター値よりも優先されます。
例
例 1: 定義とパラメーター のファイル パスを使用してロジック アプリを作成する
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/subscriptions/57b7034d-72d4-433d-ace2-a7460aed6a99/resourcegroups/ResourceGroup1/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
このコマンドは、指定したリソース グループにロジック アプリを作成します。 ロジック アプリには、ファイル パスで指定された定義とパラメーターが含まれています。
例 2: 定義オブジェクトとパラメーター オブジェクトを使用してロジック アプリを作成する
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/subscriptions/57b7034d-72d4-433d-ace2-a7460aed6a99/resourcegroups/ResourceGroup11/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
このコマンドは、指定したリソース グループ リソース グループにロジック アプリを作成します。
例 3: パイプラインを使用してリソース グループを指定してロジック アプリを作成する
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/subscriptions/57b7034d-72d4-433d-ace2-a7460aed6a99/resourcegroups/ResourceGroup11/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
このコマンドは、Get-AzureRmResourceGroup コマンドレットを使用して ResourceGroup11 という名前のリソース グループを取得します。 このコマンドは、パイプライン 演算子を使用して、そのリソース グループを現在のコマンドレットに渡します。 現在のコマンドレットは、そのリソース グループにロジック アプリを作成します。 ロジック アプリには、ファイル パスで指定された定義とパラメーターが含まれています。
例 4: 既存のロジック アプリに基づいてロジック アプリを作成する
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/subscriptions/57b7034d-72d4-433d-ace2-a7460aed6a99/resourcegroups/ResourceGroup11/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
最初のコマンドは、Get-AzureRmLogicApp コマンドレットを使用して LogicApp03 という名前のロジック アプリを取得します。 このコマンドは、ロジック アプリを $Workflow 変数に格納します。 2 番目のコマンドは、$Workflowに格納されているロジック アプリの定義とパラメーターを使用する新しいロジック アプリを作成します。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Definition
ロジック アプリの定義をオブジェクトまたは JavaScript Object Notataion (JSON) 形式の文字列として指定します。
型: | Object |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefinitionFilePath
ロジック アプリの定義を定義ファイルのパスとして JSON 形式で指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IntegrationAccountId
ロジック アプリの統合アカウント ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Location
ロジック アプリの場所を指定します。 米国西部や東南アジアなどの Azure データ センターの場所を入力します。 ロジック アプリは、任意の場所に配置できます。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
ロジック アプリの名前を指定します。
型: | String |
Aliases: | ResourceName |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ParameterFilePath
JSON 形式のパラメーター ファイルのパスを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Parameters
ロジック アプリのパラメーター コレクション オブジェクトを指定します。 ハッシュ テーブル、ディクショナリ<文字列、またはディクショナリ<文字列> WorkflowParameter> を指定します。
型: | Object |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
リソース グループの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-State
ロジック アプリの状態を指定します。 このパラメーターに使用できる値は、Enabled と Disabled です。
型: | String |
指定可能な値: | Enabled, Disabled |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |