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

New-AzFunctionApp

创建 Function App。

语法

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

说明

创建 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
默认值:None
支持通配符:False
不显示:False
别名:AppInsightsKey

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ApplicationInsightsName

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:AppInsightsName

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AppSetting

函数应用设置。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AsJob

将 cmdlet 作为后台作业运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

创建 Function App。

参数属性

类型:PSObject
默认值:None
支持通配符:False
不显示:False
别名:AzureRMContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DisableApplicationInsights

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:DisableAppInsights

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Environment

容器应用环境的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

EnvironmentForContainerApp
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-FunctionsVersion

Functions 版本。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

Consumption
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ByAppServicePlan
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IdentityID

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

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IdentityType

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

参数属性

类型:ManagedServiceIdentityType
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Image

容器映像名称,例如 publisher/image-name:tag。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:DockerImageName

参数集

EnvironmentForContainerApp
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Location

消耗计划的位置。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

Consumption
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

函数应用的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NoWait

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-OSType

用于托管函数应用的 OS。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

Consumption
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ByAppServicePlan
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PassThru

当命令成功时返回 true。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PlanName

服务计划的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

ByAppServicePlan
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CustomDockerImage
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RegistryCredential

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

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False
别名:DockerRegistryCredential

参数集

EnvironmentForContainerApp
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CustomDockerImage
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RegistryServer

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

EnvironmentForContainerApp
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceCpu

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

参数属性

类型:Double
默认值:None
支持通配符:False
不显示:False

参数集

EnvironmentForContainerApp
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceGroupName

资源组的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceMemory

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

EnvironmentForContainerApp
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Runtime

函数运行时。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

Consumption
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ByAppServicePlan
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RuntimeVersion

函数运行时。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

Consumption
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ByAppServicePlan
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ScaleMaxReplica

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

EnvironmentForContainerApp
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ScaleMinReplica

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

EnvironmentForContainerApp
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-StorageAccountName

存储帐户的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SubscriptionId

Azure 订阅 ID。

参数属性

类型:String
默认值:(Get-AzContext).Subscription.Id
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Tag

资源标记。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WorkloadProfileName

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

EnvironmentForContainerApp
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输出

ISite