Compartilhar via

New-AzFunctionApp

  • Referência
Módulo:
Az.Functions

Cria um aplicativo de funções.

Sintaxe

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

Description

Cria um aplicativo de funções.

Exemplos

Exemplo 1: criar um aplicativo de funções do PowerShell de consumo no Centro dos EUA.

New-AzFunctionApp -Name MyUniqueFunctionAppName `
                  -ResourceGroupName MyResourceGroupName `
                  -Location centralUS `
                  -StorageAccountName MyStorageAccountName `
                  -Runtime PowerShell

Esse comando cria um aplicativo de funções powershell de consumo no Centro dos EUA.

Exemplo 2: criar um aplicativo de funções do PowerShell que será hospedado em um plano de serviço.

New-AzFunctionApp -Name MyUniqueFunctionAppName `
                  -ResourceGroupName MyResourceGroupName `
                  -PlanName MyPlanName `
                  -StorageAccountName MyStorageAccountName `
                  -Runtime PowerShell

Esse comando cria um aplicativo de funções do PowerShell que será hospedado em um plano de serviço.

Exemplo 3: criar um aplicativo de funções usando uma imagem ACR privada.

New-AzFunctionApp -Name MyUniqueFunctionAppName `
                  -ResourceGroupName MyResourceGroupName `
                  -PlanName MyPlanName `
                  -StorageAccountName MyStorageAccountName `
                  -DockerImageName myacr.azurecr.io/myimage:tag

Esse comando cria um aplicativo de funções usando uma imagem ACR privada.

Exemplo 4: criar um aplicativo de funções no aplicativo de contêiner.

New-AzFunctionApp -Name MyUniqueFunctionAppName `
                  -ResourceGroupName MyResourceGroupName `
                  -StorageAccountName MyStorageAccountName `
                  -Environment MyEnvironment `
                  -WorkloadProfileName MyWorkloadProfileName

Esse comando cria um aplicativo de funções no aplicativo de contêiner usando a imagem padrão do .Net.

Parâmetros

-ApplicationInsightsKey

Chave de instrumentação do App Insights a ser adicionada.

Tipo:String
Aliases:AppInsightsKey
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ApplicationInsightsName

Nome do projeto existente do App Insights a ser adicionado ao aplicativo de funções.

Tipo:String
Aliases:AppInsightsName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AppSetting

Configurações do aplicativo de funções.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AsJob

Executa o cmdlet como um trabalho em segundo plano.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableApplicationInsights

Desabilite a criação de um recurso de application insights durante a criação do aplicativo de funções. Nenhum log estará disponível.

Tipo:SwitchParameter
Aliases:DisableAppInsights
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Environment

Nome do ambiente do aplicativo de contêiner.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FunctionsVersion

A versão do Functions.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IdentityID

Especifica a lista de identidades de usuário associadas ao aplicativo de funções. As referências de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identityies/{identityName}'

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IdentityType

Especifica o tipo de identidade usado para o aplicativo de funções. Os valores aceitáveis para este parâmetro são: - SystemAssigned - UserAssigned

Tipo:ManagedServiceIdentityType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Image

Nome da imagem do contêiner, por exemplo, publisher/image-name:tag.

Tipo:String
Aliases:DockerImageName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Location

O local do plano de consumo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

O nome do aplicativo de funções.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NoWait

Inicia a operação e retorna imediatamente, antes que a operação seja concluída. Para determinar se a operação foi concluída com êxito, use algum outro mecanismo.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OSType

O sistema operacional para hospedar o aplicativo de funções.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Retorna true quando o comando é bem-sucedido.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PlanName

O nome do plano de serviço.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RegistryCredential

O nome de usuário e a senha do registro de contêiner. Necessário para registros privados.

Tipo:PSCredential
Aliases:DockerRegistryCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RegistryServer

O nome do host do servidor do registro de contêiner, por exemplo, myregistry.azurecr.io.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceCpu

A CPU em núcleos do aplicativo de contêiner. por exemplo, 0,75.

Tipo:Double
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

O nome do grupo de recursos.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceMemory

O tamanho da memória do aplicativo de contêiner. por exemplo, 1,0Gi.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Runtime

O runtime da função.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RuntimeVersion

O runtime da função.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScaleMaxReplica

O número máximo de réplicas ao criar um aplicativo de funções no aplicativo de contêiner.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScaleMinReplica

O número mínimo de réplicas ao criar um aplicativo de funções no aplicativo de contêiner.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StorageAccountName

O nome da conta de armazenamento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SubscriptionId

A ID da assinatura do Azure.

Tipo:String
Cargo:Named
Valor padrão:(Get-AzContext).Subscription.Id
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Tag

Marcas de recurso.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WorkloadProfileName

O nome do perfil de carga de trabalho no qual executar o aplicativo de contêiner.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

ISite