你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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
别名:	AppInsightsKey
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ApplicationInsightsName

要添加到函数应用的现有 App Insights 项目的名称。

类型:	String
别名:	AppInsightsName
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AppSetting

函数应用设置。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AsJob

将 cmdlet 作为后台作业运行。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

类型:	PSObject
别名:	AzureRMContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableApplicationInsights

在函数应用创建过程中禁用创建 application Insights 资源。 不会提供任何日志。

类型:	SwitchParameter
别名:	DisableAppInsights
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Environment

容器应用环境的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-FunctionsVersion

Functions 版本。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IdentityID

指定与函数应用关联的用户标识列表。 用户标识引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}”

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IdentityType

指定用于函数应用的标识类型。 此参数的可接受值为： - SystemAssigned - UserAssigned

类型:	ManagedServiceIdentityType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Image

容器映像名称，例如 publisher/image-name：tag。

类型:	String
别名:	DockerImageName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Location

消耗计划的位置。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Name

函数应用的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NoWait

在操作完成之前立即启动操作并返回。 若要确定操作是否已成功完成，请使用一些其他机制。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OSType

用于托管函数应用的 OS。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PassThru

当命令成功时返回 true。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PlanName

服务计划的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RegistryCredential

容器注册表用户名和密码。 专用注册表是必需的。

类型:	PSCredential
别名:	DockerRegistryCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RegistryServer

容器注册表服务器主机名，例如 myregistry.azurecr.io。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceCpu

容器应用核心中的 CPU。 例如 0.75。

类型:	Double
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

资源组的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ResourceMemory

容器应用的内存大小。 例如 1.0Gi。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Runtime

函数运行时。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RuntimeVersion

函数运行时。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ScaleMaxReplica

在容器应用中创建函数应用时的最大副本数。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ScaleMinReplica

在容器应用上创建函数应用时，副本的最小数量。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StorageAccountName

存储帐户的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SubscriptionId

Azure 订阅 ID。

类型:	String
Position:	Named
默认值:	(Get-AzContext).Subscription.Id
必需:	False
接受管道输入:	False
接受通配符:	False

-Tag

资源标记。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WorkloadProfileName

要在其中运行容器应用的工作负荷配置文件名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输出

ISite