New-AzFunctionApp

模組:

Az.Functions Module

建立函式應用程式。

語法

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

FlexConsumption

New-AzFunctionApp
    -ResourceGroupName <String>
    -Name <String>
    -StorageAccountName <String>
    -Runtime <String>
    -FlexConsumptionLocation <String>
    [-SubscriptionId <String>]
    [-ApplicationInsightsName <String>]
    [-ApplicationInsightsKey <String>]
    [-RuntimeVersion <String>]
    [-DisableApplicationInsights]
    [-PassThru]
    [-Tag <Hashtable>]
    [-AppSetting <Hashtable>]
    [-IdentityType <ManagedServiceIdentityType>]
    [-IdentityID <String[]>]
    [-DeploymentStorageName <String>]
    [-DeploymentStorageContainerName <String>]
    [-DeploymentStorageAuthType <String>]
    [-DeploymentStorageAuthValue <String>]
    [-AlwaysReady <Hashtable[]>]
    [-MaximumInstanceCount <Int32>]
    [-InstanceMemoryMB <Int32>]
    [-HttpPerInstanceConcurrency <Int32>]
    [-EnableZoneRedundancy]
    [-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>]

Description

建立函式應用程式。

範例

範例 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 映像檔。

範例 5：建立一個 PowerShell 函式應用程式，託管在 Flex Consumption 方案中。

New-AzFunctionApp -Name MyUniqueFunctionAppName `
                  -ResourceGroupName MyResourceGroupName `
                  -FlexConsumptionLocation LocationWhereFlexConsumptionIsSupported `
                  -StorageAccountName MyStorageAccountName `
                  -Runtime PowerShell

此指令會建立一個 PowerShell 函式應用程式，託管於 Flex Consumption 方案中。

參數

-AlwaysReady

描述 AlwaysReady 配置的雜湊表陣列。 每個雜湊表必須包含：

• 名稱：功能名稱或路由名稱。
• instanceCount：該函式預熱實例的數量。

範例：@（@{ name = “http”;instanceCount = 2 }）。

參數屬性

類型:	Hashtable[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

FlexConsumption

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ApplicationInsightsKey

要新增的 App Insights 檢測金鑰。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AppInsights索引鍵

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ApplicationInsightsName

要新增至函式應用程式的現有 App Insights 項目名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AppInsights名稱

參數集

(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
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DefaultProfile

建立函式應用程式。

參數屬性

類型:	PSObject
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzureRMContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DeploymentStorageAuthType

部署儲存認證類型。 允許的值：StorageAccountConnectionString、SystemAssignedIdentity、UserAssignedIdentity

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

FlexConsumption

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DeploymentStorageAuthValue

部署儲存驗證值用於所選的認證類型（例如：連線字串或使用者指派的身份資源 ID）。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

FlexConsumption

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DeploymentStorageContainerName

部署儲存容器名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

FlexConsumption

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DeploymentStorageName

用於函式應用產物的部署儲存帳號名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

FlexConsumption

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DisableApplicationInsights

在建立函式應用程式期間停用建立 Application Insights 資源。 將無法使用任何記錄。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	DisableAppInsights

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EnableZoneRedundancy

啟用高可用性的區域備援。 僅適用於彈性取用 SKU。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

FlexConsumption

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Environment

容器應用程式環境的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

EnvironmentForContainerApp

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-FlexConsumptionLocation

建立彈性消費功能應用程式的地點。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

FlexConsumption

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-FunctionsVersion

函數版本。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

Consumption

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ByAppServicePlan

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-HttpPerInstanceConcurrency

每個實例的並行 HTTP 觸發程式調用數目上限。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

FlexConsumption

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IdentityID

指定與函式應用程式相關聯的使用者身分識別清單。 使用者身分識別參考會是 ARM 資源識別碼，格式為：'/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

-InstanceMemoryMB

Flex Consumption 實例的每個實例記憶體以 MB 計算。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

FlexConsumption

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Location

取用方案的位置。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

Consumption

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MaximumInstanceCount

彈性消耗的最大實例數。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

FlexConsumption

Position:	Named
必要:	False
來自管線的值:	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
別名:	DockerRegistry認證

參數集

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

FlexConsumption

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

FlexConsumption

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 訂閱識別碼。

參數屬性

類型:	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