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을 백그라운드 작업으로 실행합니다.
매개 변수 속성
매개 변수 집합
(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에만 적용됩니다.
매개 변수 속성
매개 변수 집합
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
매개 변수 속성
매개 변수 집합
(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
작업을 시작하고 작업이 완료되기 전에 즉시 반환합니다.
작업이 성공적으로 완료되었는지 확인하려면 다른 메커니즘을 사용합니다.
매개 변수 속성
매개 변수 집합
(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를 반환합니다.
매개 변수 속성
매개 변수 집합
(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 를 참조하세요.
출력