New-AzFunctionApp

モジュール:

Az.Functions

Function App を作成します。

構文

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>]

New-AzFunctionApp
   -ResourceGroupName <String>
   -Name <String>
   -StorageAccountName <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[]>]
   -PlanName <String>
   [-DefaultProfile <PSObject>]
   [-NoWait]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzFunctionApp
   -ResourceGroupName <String>
   -Name <String>
   -StorageAccountName <String>
   [-SubscriptionId <String>]
   [-ApplicationInsightsName <String>]
   [-ApplicationInsightsKey <String>]
   [-DisableApplicationInsights]
   [-PassThru]
   [-Tag <Hashtable>]
   [-AppSetting <Hashtable>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityID <String[]>]
   -Environment <String>
   [-Image <String>]
   [-RegistryCredential <PSCredential>]
   [-WorkloadProfileName <String>]
   [-ResourceCpu <Double>]
   [-ResourceMemory <String>]
   [-ScaleMaxReplica <Int32>]
   [-ScaleMinReplica <Int32>]
   [-RegistryServer <String>]
   [-DefaultProfile <PSObject>]
   [-NoWait]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzFunctionApp
   -ResourceGroupName <String>
   -Name <String>
   -StorageAccountName <String>
   [-SubscriptionId <String>]
   [-ApplicationInsightsName <String>]
   [-ApplicationInsightsKey <String>]
   [-DisableApplicationInsights]
   [-PassThru]
   [-Tag <Hashtable>]
   [-AppSetting <Hashtable>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityID <String[]>]
   -Image <String>
   [-RegistryCredential <PSCredential>]
   -PlanName <String>
   [-DefaultProfile <PSObject>]
   [-NoWait]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Function App を作成します。

例

例 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
Aliases:	AppInsightsKey
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ApplicationInsightsName

関数アプリに追加する既存の App Insights プロジェクトの名前。

型:	String
Aliases:	AppInsightsName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AppSetting

関数アプリの設定。

型:	Hashtable
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AsJob

コマンドレットをバックグラウンド ジョブとして実行します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

型:	PSObject
Aliases:	AzureRMContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableApplicationInsights

関数アプリの作成時に Application Insights リソースの作成を無効にします。 ログは使用できません。

型:	SwitchParameter
Aliases:	DisableAppInsights
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Environment

コンテナー アプリ環境の名前。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FunctionsVersion

Functions のバージョン。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IdentityID

関数アプリに関連付けられているユーザー ID の一覧を指定します。 ユーザー ID 参照は、"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identits/{identityName}" という形式の ARM リソース ID になります。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IdentityType

関数アプリに使用される ID の種類を指定します。 このパラメーターに使用できる値は、 - SystemAssigned - UserAssigned です。

型:	ManagedServiceIdentityType
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Image

コンテナー イメージ名 (publisher/image-name:tag など)。

型:	String
Aliases:	DockerImageName
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Location

従量課金プランの場所。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

Function App の名前。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NoWait

操作を開始し、操作が完了する直前に戻ります。 操作が正常に完了したかどうかを判断するには、他のメカニズムを使用します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OSType

関数アプリをホストする OS。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

コマンドが成功した場合は true を返します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PlanName

サービス プランの名前。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RegistryCredential

コンテナー レジストリのユーザー名とパスワード。 プライベート レジストリに必要です。

型:	PSCredential
Aliases:	DockerRegistryCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RegistryServer

コンテナー レジストリ サーバーのホスト名 (例: myregistry.azurecr.io)。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResourceCpu

コンテナー アプリのコア内の CPU。 例: 0.75。

型:	Double
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResourceGroupName

リソース グループの名前。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResourceMemory

コンテナー アプリのメモリ サイズ。 例: 1.0Gi。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Runtime

関数ランタイム。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RuntimeVersion

関数ランタイム。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ScaleMaxReplica

コンテナー アプリで関数アプリを作成するときのレプリカの最大数。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ScaleMinReplica

コンテナー アプリで関数アプリを作成するときのレプリカの最小数。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-StorageAccountName

ストレージ アカウントの名前。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SubscriptionId

Azure サブスクリプション ID。

型:	String
配置:	Named
規定値:	(Get-AzContext).Subscription.Id
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Tag

リソース タグ。

型:	Hashtable
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WorkloadProfileName

コンテナー アプリを実行するワークロード プロファイル名。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

出力

ISite