다음을 통해 공유


New-AzFunctionApp

함수 앱을 만듭니다.

구문

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: Flex Consumption 계획에서 호스트되는 PowerShell 함수 앱을 만듭니다.

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

이 명령은 Flex Consumption 계획에서 호스트되는 PowerShell 함수 앱을 만듭니다.

매개 변수

-AlwaysReady

AlwaysReady 구성을 설명하는 해시 테이블의 배열입니다. 각 해시 테이블은 다음을 포함해야 합니다.

  • name: 함수 이름 또는 경로 이름입니다.
  • instanceCount: 해당 함수의 미리 준비된 인스턴스 수입니다.

예: @(@{ name = "http"; instanceCount = 2 }).

매개 변수 속성

형식:

Hashtable[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

FlexConsumption
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ApplicationInsightsKey

추가할 App Insights의 계측 키입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:AppInsightsKey

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ApplicationInsightsName

함수 앱에 추가할 기존 App Insights 프로젝트의 이름입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:AppInsightsName

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-AppSetting

함수 앱 설정입니다.

매개 변수 속성

형식:Hashtable
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-AsJob

cmdlet을 백그라운드 작업으로 실행합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DefaultProfile

함수 앱을 만듭니다.

매개 변수 속성

형식:PSObject
Default value:None
와일드카드 지원:False
DontShow:False
별칭:AzureRMContext, AzureCredential

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DeploymentStorageAuthType

배포 스토리지 인증 유형입니다. 허용되는 값: StorageAccountConnectionString, SystemAssignedIdentity, UserAssignedIdentity

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

FlexConsumption
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DeploymentStorageAuthValue

선택한 인증 유형(예: 연결 문자열 또는 사용자 할당 ID 리소스 ID)에 사용되는 배포 스토리지 인증 값입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

FlexConsumption
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DeploymentStorageContainerName

배포 스토리지 컨테이너 이름입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

FlexConsumption
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DeploymentStorageName

함수 앱 아티팩트에서 사용할 배포 스토리지 계정의 이름입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

FlexConsumption
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DisableApplicationInsights

함수 앱을 만드는 동안 Application Insights 리소스 만들기를 사용하지 않도록 설정합니다. 로그를 사용할 수 없습니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:DisableAppInsights

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-EnableZoneRedundancy

고가용성을 위해 영역 중복을 사용하도록 설정합니다. Flex Consumption SKU에만 적용됩니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

FlexConsumption
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Environment

컨테이너 앱 환경의 이름입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

EnvironmentForContainerApp
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-FlexConsumptionLocation

Flex Consumption 함수 앱을 만들 위치입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

FlexConsumption
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-FunctionsVersion

Functions 버전입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Consumption
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
ByAppServicePlan
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-HttpPerInstanceConcurrency

인스턴스당 동시 HTTP 트리거 호출의 최대 수입니다.

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

FlexConsumption
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-IdentityID

함수 앱과 연결된 사용자 ID 목록을 지정합니다. 사용자 ID 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}' 형식의 ARM 리소스 ID입니다.

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-IdentityType

함수 앱에 사용되는 ID 유형을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다. - SystemAssigned - UserAssigned

매개 변수 속성

형식:ManagedServiceIdentityType
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Image

컨테이너 이미지 이름(예: publisher/image-name:tag)입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:DockerImageName

매개 변수 집합

EnvironmentForContainerApp
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-InstanceMemoryMB

Flex Consumption 인스턴스의 경우 인스턴스당 메모리(MB)입니다.

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

FlexConsumption
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Location

소비 계획의 위치입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Consumption
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-MaximumInstanceCount

Flex 소비의 최대 인스턴스 수입니다.

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

FlexConsumption
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Name

함수 앱의 이름입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-NoWait

작업을 시작하고 작업이 완료되기 전에 즉시 반환합니다. 작업이 성공적으로 완료되었는지 확인하려면 다른 메커니즘을 사용합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-OSType

함수 앱을 호스트할 OS입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Consumption
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
ByAppServicePlan
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-PassThru

명령이 성공하면 true를 반환합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-PlanName

서비스 계획의 이름입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ByAppServicePlan
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
CustomDockerImage
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-RegistryCredential

컨테이너 레지스트리 사용자 이름 및 암호입니다. 프라이빗 레지스트리에 필요합니다.

매개 변수 속성

형식:PSCredential
Default value:None
와일드카드 지원:False
DontShow:False
별칭:DockerRegistryCredential

매개 변수 집합

EnvironmentForContainerApp
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
CustomDockerImage
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-RegistryServer

컨테이너 레지스트리 서버 호스트 이름(예: myregistry.azurecr.io)입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

EnvironmentForContainerApp
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ResourceCpu

컨테이너 앱의 코어에 있는 CPU입니다. 예: 0.75.

매개 변수 속성

형식:Double
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

EnvironmentForContainerApp
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ResourceGroupName

리소스 그룹의 이름입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ResourceMemory

컨테이너 앱의 메모리 크기입니다. 예: 1.0Gi.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

EnvironmentForContainerApp
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Runtime

함수 런타임입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Consumption
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
ByAppServicePlan
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
FlexConsumption
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-RuntimeVersion

함수 런타임입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Consumption
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
ByAppServicePlan
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
FlexConsumption
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ScaleMaxReplica

컨테이너 앱에서 함수 앱을 만들 때의 최대 복제본 수입니다.

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

EnvironmentForContainerApp
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ScaleMinReplica

컨테이너 앱에서 함수 앱을 만들 때의 최소 복제본 수입니다.

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

EnvironmentForContainerApp
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-StorageAccountName

스토리지 계정 이름입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SubscriptionId

Azure 구독 ID.

매개 변수 속성

형식:String
Default value:(Get-AzContext).Subscription.Id
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Tag

리소스 태그.

매개 변수 속성

형식:Hashtable
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WorkloadProfileName

컨테이너 앱을 실행할 워크로드 프로필 이름입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow: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