New-AzFunctionApp
構文
Consumption (既定)
New-AzFunctionApp
-ResourceGroupName <String>
-Name <String>
-StorageAccountName <String>
-Location <String>
-Runtime <String>
[-SubscriptionId <String>]
[-ApplicationInsightsName <String>]
[-ApplicationInsightsKey <String>]
[-OSType <String>]
[-RuntimeVersion <String>]
[-FunctionsVersion <String>]
[-DisableApplicationInsights]
[-PassThru]
[-Tag <Hashtable>]
[-AppSetting <Hashtable>]
[-IdentityType <ManagedServiceIdentityType>]
[-IdentityID <String[]>]
[-DefaultProfile <PSObject>]
[-NoWait]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByAppServicePlan
New-AzFunctionApp
-ResourceGroupName <String>
-Name <String>
-StorageAccountName <String>
-Runtime <String>
-PlanName <String>
[-SubscriptionId <String>]
[-ApplicationInsightsName <String>]
[-ApplicationInsightsKey <String>]
[-OSType <String>]
[-RuntimeVersion <String>]
[-FunctionsVersion <String>]
[-DisableApplicationInsights]
[-PassThru]
[-Tag <Hashtable>]
[-AppSetting <Hashtable>]
[-IdentityType <ManagedServiceIdentityType>]
[-IdentityID <String[]>]
[-DefaultProfile <PSObject>]
[-NoWait]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
EnvironmentForContainerApp
New-AzFunctionApp
-ResourceGroupName <String>
-Name <String>
-StorageAccountName <String>
-Environment <String>
[-SubscriptionId <String>]
[-ApplicationInsightsName <String>]
[-ApplicationInsightsKey <String>]
[-DisableApplicationInsights]
[-PassThru]
[-Tag <Hashtable>]
[-AppSetting <Hashtable>]
[-IdentityType <ManagedServiceIdentityType>]
[-IdentityID <String[]>]
[-Image <String>]
[-RegistryCredential <PSCredential>]
[-WorkloadProfileName <String>]
[-ResourceCpu <Double>]
[-ResourceMemory <String>]
[-ScaleMaxReplica <Int32>]
[-ScaleMinReplica <Int32>]
[-RegistryServer <String>]
[-DefaultProfile <PSObject>]
[-NoWait]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CustomDockerImage
New-AzFunctionApp
-ResourceGroupName <String>
-Name <String>
-StorageAccountName <String>
-Image <String>
-PlanName <String>
[-SubscriptionId <String>]
[-ApplicationInsightsName <String>]
[-ApplicationInsightsKey <String>]
[-DisableApplicationInsights]
[-PassThru]
[-Tag <Hashtable>]
[-AppSetting <Hashtable>]
[-IdentityType <ManagedServiceIdentityType>]
[-IdentityID <String[]>]
[-RegistryCredential <PSCredential>]
[-DefaultProfile <PSObject>]
[-NoWait]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
例
例 1: 米国中部で消費 PowerShell 関数アプリを作成する。
New-AzFunctionApp -Name MyUniqueFunctionAppName `
-ResourceGroupName MyResourceGroupName `
-Location centralUS `
-StorageAccountName MyStorageAccountName `
-Runtime PowerShell
このコマンドは、米国中部に従量課金 PowerShell 関数アプリを作成します。
例 2: サービス プランでホストされる PowerShell 関数アプリを作成する。
New-AzFunctionApp -Name MyUniqueFunctionAppName `
-ResourceGroupName MyResourceGroupName `
-PlanName MyPlanName `
-StorageAccountName MyStorageAccountName `
-Runtime PowerShell
このコマンドは、サービス プランでホストされる PowerShell 関数アプリを作成します。
例 3: プライベート ACR イメージを使用して関数アプリを作成する。
New-AzFunctionApp -Name MyUniqueFunctionAppName `
-ResourceGroupName MyResourceGroupName `
-PlanName MyPlanName `
-StorageAccountName MyStorageAccountName `
-DockerImageName myacr.azurecr.io/myimage:tag
このコマンドは、プライベート ACR イメージを使用して関数アプリを作成します。
例 4: コンテナー アプリで関数アプリを作成する。
New-AzFunctionApp -Name MyUniqueFunctionAppName `
-ResourceGroupName MyResourceGroupName `
-StorageAccountName MyStorageAccountName `
-Environment MyEnvironment `
-WorkloadProfileName MyWorkloadProfileName
このコマンドは、既定の .Net イメージを使用してコンテナー アプリに関数アプリを作成します。
パラメーター
-ApplicationInsightsKey
追加する App Insights のインストルメンテーション キー。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: AppInsightsKey
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ApplicationInsightsName
関数アプリに追加する既存の App Insights プロジェクトの名前。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: AppInsightsName
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-AppSetting
関数アプリの設定。
パラメーターのプロパティ
型: Hashtable
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-AsJob
コマンドレットをバックグラウンド ジョブとして実行します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-DefaultProfile
Function App を作成します。
パラメーターのプロパティ
型: PSObject
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: AzureRMContext, AzureCredential
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-DisableApplicationInsights
関数アプリの作成時に Application Insights リソースの作成を無効にします。
ログは使用できません。
パラメーターのプロパティ
型: SwitchParameter
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: DisableAppInsights
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Environment
コンテナー アプリ環境の名前。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
EnvironmentForContainerApp
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-FunctionsVersion
Functions のバージョン。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
Consumption
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
ByAppServicePlan
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-IdentityID
関数アプリに関連付けられているユーザー ID の一覧を指定します。
ユーザー ID 参照は、"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identits/{identityName}" という形式の ARM リソース ID になります。
パラメーターのプロパティ
型: String [ ]
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-IdentityType
関数アプリに使用される ID の種類を指定します。
このパラメーターに使用できる値は、 - SystemAssigned - UserAssigned です。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Image
コンテナー イメージ名 (publisher/image-name:tag など)。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: DockerImageName
パラメーター セット
EnvironmentForContainerApp
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Location
従量課金プランの場所。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
Consumption
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Name
Function App の名前。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-NoWait
操作を開始し、操作が完了する直前に戻ります。
操作が正常に完了したかどうかを判断するには、他のメカニズムを使用します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-OSType
関数アプリをホストする OS。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
Consumption
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
ByAppServicePlan
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-PassThru
コマンドが成功した場合は true を返します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-PlanName
サービス プランの名前。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
ByAppServicePlan
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
CustomDockerImage
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-RegistryCredential
コンテナー レジストリのユーザー名とパスワード。
プライベート レジストリに必要です。
パラメーターのプロパティ
型: PSCredential
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: DockerRegistryCredential
パラメーター セット
EnvironmentForContainerApp
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
CustomDockerImage
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-RegistryServer
コンテナー レジストリ サーバーのホスト名 (例: myregistry.azurecr.io)。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
EnvironmentForContainerApp
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ResourceCpu
コンテナー アプリのコア内の CPU。
例: 0.75。
パラメーターのプロパティ
型: Double
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
EnvironmentForContainerApp
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ResourceGroupName
リソース グループの名前。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ResourceMemory
コンテナー アプリのメモリ サイズ。
例: 1.0Gi。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
EnvironmentForContainerApp
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Runtime
関数ランタイム。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
Consumption
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
ByAppServicePlan
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-RuntimeVersion
関数ランタイム。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
Consumption
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
ByAppServicePlan
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ScaleMaxReplica
コンテナー アプリで関数アプリを作成するときのレプリカの最大数。
パラメーターのプロパティ
型: Int32
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
EnvironmentForContainerApp
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ScaleMinReplica
コンテナー アプリで関数アプリを作成するときのレプリカの最小数。
パラメーターのプロパティ
型: Int32
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
EnvironmentForContainerApp
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-StorageAccountName
ストレージ アカウントの名前。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-SubscriptionId
Azure サブスクリプション ID。
パラメーターのプロパティ
型: String
規定値: (Get-AzContext).Subscription.Id
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Tag
リソース タグ。
パラメーターのプロパティ
型: Hashtable
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
型: SwitchParameter
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: ウィスコンシン
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-WorkloadProfileName
コンテナー アプリを実行するワークロード プロファイル名。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
EnvironmentForContainerApp
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParameters を参照してください。
出力