New-AzResourceGroupDeployment

참조

모듈:: Az.Resources

리소스 그룹에 Azure 배포를 추가합니다.

구문

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterObject <Hashtable>
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterObject <Hashtable>
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterObject <Hashtable>
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterObject <Hashtable>
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterUri <String>
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterUri <String>
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterUri <String>
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateParameterUri <String>
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Tag <Hashtable>]
   [-WhatIfResultFormat <WhatIfResultFormat>]
   [-WhatIfExcludeChangeType <String[]>]
   [-Force]
   [-ProceedIfNoChange]
   [-AsJob]
   [-AuxTenant <String[]>]
   [-QueryString <String>]
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzResourceGroupDeployment cmdlet은 기존 리소스 그룹에 배포를 추가합니다. 여기에는 배포에 필요한 리소스가 포함됩니다. Azure 리소스는 데이터베이스 서버, 데이터베이스, 웹 사이트, 가상 머신 또는 Storage 계정과 같은 사용자 관리형 Azure 엔터티입니다. Azure 리소스 그룹은 웹 사이트, 데이터베이스 서버 및 재무 웹 사이트에 필요한 데이터베이스와 같은 단위로 배포되는 Azure 리소스의 컬렉션입니다. 리소스 그룹 배포는 템플릿을 사용하여 리소스 그룹에 리소스를 추가하고 Azure에서 사용할 수 있도록 게시합니다. 템플릿을 사용하지 않고 리소스 그룹에 리소스를 추가하려면 New-AzResource cmdlet을 사용합니다. 리소스 그룹 배포를 추가하려면 기존 리소스 그룹 및 리소스 그룹 템플릿의 이름을 지정합니다. 리소스 그룹 템플릿은 웹 포털과 같은 복잡한 클라우드 기반 서비스에 대한 리소스 그룹을 나타내는 JSON 문자열입니다. 템플릿에는 필요한 리소스에 대한 매개 변수 자리 표시자와 이름 및 크기와 같은 구성 가능한 속성 값이 포함됩니다. Azure 템플릿 갤러리에서 많은 템플릿을 찾거나 고유한 템플릿을 만들 수 있습니다. 사용자 지정 템플릿을 사용하여 리소스 그룹을 만들려면 TemplateFile 매개 변수 또는 TemplateUri 매개 변수를 지정합니다. 각 템플릿에는 구성 가능한 속성에 대한 매개 변수가 있습니다. 템플릿 매개 변수의 값을 지정하려면 TemplateParameterFile 매개 변수 또는 TemplateParameterObject 매개 변수를 지정합니다. 또는 템플릿을 지정할 때 명령에 동적으로 추가되는 템플릿 매개 변수를 사용할 수 있습니다. 동적 매개 변수를 사용하려면 명령 프롬프트에 입력하거나 빼기 기호(-)를 입력하여 매개 변수를 나타내고 Tab 키를 사용하여 사용 가능한 매개 변수를 순환합니다. 명령 프롬프트에서 입력하는 템플릿 매개 변수 값이 템플릿 매개 변수 개체 또는 파일의 값보다 우선합니다.

예제

예제 1: 사용자 지정 템플릿 및 매개 변수 파일을 사용하여 배포 만들기

New-AzResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json" -Tag @{"key1"="value1"; "key2"="value2";}

이 명령은 정의된 태그 매개 변수를 사용하여 사용자 지정 템플릿 및 디스크의 템플릿 파일을 사용하여 새 배포를 만듭니다. 해당 명령은 TemplateFile 매개 변수를 사용하여 해당 템플릿을 지정하며 TemplateParameterFile 매개 변수를 사용하여 매개 변수 및 매개 변숫값이 들어 있는 파일을 지정합니다.

예제 2: 사용자 지정 템플릿 개체 및 매개 변수 파일을 사용하여 배포 만들기

$TemplateFileText = [System.IO.File]::ReadAllText("D:\Azure\Templates\EngineeringSite.json")
$TemplateObject = ConvertFrom-Json $TemplateFileText -AsHashtable
New-AzResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateObject $TemplateObject -TemplateParameterFile "D:\Azure\Templates\EngSiteParams.json"

이 명령은 메모리 내 해시 테이블로 변환된 디스크에 사용자 지정 및 템플릿 파일을 사용하여 새 배포를 만듭니다. 처음 두 명령은 디스크의 템플릿 파일에 대한 텍스트를 읽고 메모리 내 해시 테이블로 변환합니다. 마지막 명령은 TemplateObject 매개 변수를 사용하여 해시 테이블 및 TemplateParameterFile 매개 변수를 지정하여 매개 변수 및 매개 변수 값이 포함된 파일을 지정합니다.

예제 3

리소스 그룹에 Azure 배포를 추가합니다. (자동 생성됨)

New-AzResourceGroupDeployment -DeploymentDebugLogLevel RequestContent -Name mynewstorageaccount -ResourceGroupName 'ContosoEngineering' -TemplateFile 'D:\Azure\Templates\EngineeringSite.json' -TemplateParameterObject <Hashtable>

예제 4: URI 및 SAS 토큰을 사용하여 공용이 아닌 스토리지 계정에 저장된 템플릿 배포

New-AzResourceGroupDeployment -ResourceGroupName "RGName" -TemplateUri "https://example.com/example.json" -QueryString "foo"

이 명령은 TemplateUri의 템플릿을 사용하여 새 배포를 만듭니다. 이 템플릿은 공용이 아니며 QueryString 매개 변수를 사용하여 제공되는 액세스에 토큰 매개 변수가 필요합니다. 이 명령을 실행하면 URL https://example.com/example.json?foo을 사용하여 템플릿에 효과적으로 액세스합니다. SAS 토큰을 QueryString으로 제공하여 스토리지 계정에서 템플릿을 사용하려는 경우 사용할 수 있습니다.

예제 5: .bicepparam 파일을 사용하여 배포 만들기

New-AzResourceGroupDeployment -ResourceGroupName "RGName"  -TemplateParameterFile "./parameters.bicepparam"

이 명령은 디스크에서 .bicepparam 파일을 사용하여 리소스 그룹 범위에 새 배포를 만듭니다. 이 명령은 TemplateParameterFile 매개 변수를 사용하여 .bicepparam 파일을 지정합니다.

매개 변수

-AsJob

백그라운드에서 cmdlet 실행

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AuxTenant

교차 테넌트 배포에 대한 보조 테넌트 ID

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

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

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독

형식:	IAzureContextContainer
별칭:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeploymentDebugLogLevel

디버그 로그 수준을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

RequestContent
ResponseContent
모두
None

형식:	String
허용되는 값:	RequestContent, ResponseContent, All, None
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Force

사용자 확인을 요청하지 않고 명령을 강제 실행합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Mode

배포 모드를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

완료: 전체 모드에서 Resource Manager는 리소스 그룹에 있지만 템플릿에 지정되지 않은 리소스를 삭제합니다.
증분: 증분 모드에서 Resource Manager는 리소스 그룹에 있지만 템플릿에 지정되지 않은 변경되지 않은 리소스를 남깁니다.

형식:	DeploymentMode
허용되는 값:	Incremental, Complete
Position:	Named
Default value:	Incremental
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Name

만들려는 배포의 이름입니다. 지정하지 않으면 템플릿 파일이 제공되면 기본적으로 템플릿 파일 이름이 지정됩니다. 기본값은 템플릿 개체가 제공되는 현재 시간(예: "20131223140835")입니다.

형식:	String
별칭:	DeploymentName
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Pre

이 cmdlet은 사용할 버전을 자동으로 결정할 때 시험판 API 버전을 고려한다는 것을 나타냅니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ProceedIfNoChange

What-If 결과에 변경 내용이 없는 경우 확인을 요청하지 마세요. -Confirm 스위치가 설정된 경우에 적용됩니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-QueryString

TemplateUri 매개 변수와 함께 사용할 쿼리 문자열(예: SAS 토큰)입니다. 연결된 템플릿의 경우 사용됩니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ResourceGroupName

배포할 리소스 그룹의 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-RollBackDeploymentName

-RollbackToLastDeployment를 사용하는 경우 리소스 그룹에서 지정된 이름을 사용하여 성공적인 배포로 롤백하면 안 됩니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-RollbackToLastDeployment

-RollBackDeploymentName을 사용하는 경우 리소스 그룹에서 마지막으로 성공한 배포로 롤백하면 안 됩니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SkipTemplateParameterPrompt

제공된 템플릿 매개 변수에 템플릿에서 사용하는 모든 필수 매개 변수가 포함되어 있는지 확인하는 PowerShell 동적 매개 변수 처리를 건너뜁니다. 이 검사는 사용자에게 누락된 매개 변수에 대한 값을 제공하라는 메시지를 표시하지만 -SkipTemplateParameterPrompt를 제공하면 이 프롬프트가 무시되고 매개 변수가 템플릿에 바인딩되지 않은 경우 즉시 오류가 발생합니다. 비대화형 스크립트의 경우 모든 필수 매개 변수가 충족되지 않는 경우 더 나은 오류 메시지를 제공하기 위해 -SkipTemplateParameterPrompt를 제공할 수 있습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Tag

배포에 넣을 태그입니다.

형식:	Hashtable
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-TemplateFile

사용자 지정 템플릿 파일의 전체 경로를 지정합니다. 지원되는 템플릿 파일 형식: json 및 bicep.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-TemplateObject

템플릿을 나타내는 해시 테이블입니다.

형식:	Hashtable
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-TemplateParameterFile

템플릿 매개 변수의 이름과 값을 포함하는 JSON 파일의 전체 경로를 지정합니다. 템플릿에 매개 변수가 있는 경우 TemplateParameterFile 매개 변수 또는 TemplateParameterObject 매개 변수를 사용하여 매개 변수 값을 지정해야 합니다. 템플릿 매개 변수는 템플릿을 지정할 때 명령에 동적으로 추가됩니다. 동적 매개 변수를 사용하려면 빼기 기호(-)를 입력하여 매개 변수 이름을 표시한 다음 Tab 키를 사용하여 사용 가능한 매개 변수를 순환합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-TemplateParameterObject

템플릿 매개 변수 이름 및 값의 해시 테이블을 지정합니다. Windows PowerShell의 해시 테이블에 대한 도움말을 보려면 다음을 입력합니다 Get-Help about_Hash_Tables. 템플릿에 매개 변수가 있는 경우 매개 변수 값을 지정해야 합니다. 템플릿 매개 변수는 템플릿을 지정할 때 명령에 동적으로 추가됩니다.

형식:	Hashtable
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-TemplateParameterUri

템플릿 매개 변수 파일의 URI를 지정합니다. TemplateParameterUri를 사용하는 경우 사용하는 동적 매개 변수는 무시됩니다. 동적 매개 변수를 사용하려면 TemplateParameterFile 매개 변수를 대신 사용해야 합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-TemplateSpecId

배포할 templateSpec의 리소스 ID입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-TemplateUri

사용자 지정 템플릿 파일의 URI를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIfExcludeChangeType

What-If 결과에서 제외할 쉼표로 구분된 리소스 변경 형식입니다. -WhatIf 또는 -Confirm 스위치가 설정된 경우에 적용됩니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIfResultFormat

What-If 결과 형식입니다.

형식:	WhatIfResultFormat
허용되는 값:	ResourceIdOnly, FullResourcePayloads
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

String

DeploymentMode

Hashtable

출력

PSResourceGroupDeployment

다음을 통해 공유

New-AzResourceGroupDeployment

구문

Description

예제

예제 1: 사용자 지정 템플릿 및 매개 변수 파일을 사용하여 배포 만들기

예제 2: 사용자 지정 템플릿 개체 및 매개 변수 파일을 사용하여 배포 만들기

예제 3

예제 4: URI 및 SAS 토큰을 사용하여 공용이 아닌 스토리지 계정에 저장된 템플릿 배포

예제 5: .bicepparam 파일을 사용하여 배포 만들기

매개 변수

-AsJob

-AuxTenant

-Confirm

-DefaultProfile

-DeploymentDebugLogLevel

-Force

-Mode

-Name

-Pre

-ProceedIfNoChange

-QueryString

-ResourceGroupName

-RollBackDeploymentName

-RollbackToLastDeployment

-SkipTemplateParameterPrompt

-Tag

-TemplateFile

-TemplateObject

-TemplateParameterFile

-TemplateParameterObject

-TemplateParameterUri

-TemplateSpecId

-TemplateUri

-WhatIf

-WhatIfExcludeChangeType

-WhatIfResultFormat

입력

출력

추가 리소스

다음을 통해 공유

New-AzResourceGroupDeployment

구문

Description

예제

예제 1: 사용자 지정 템플릿 및 매개 변수 파일을 사용하여 배포 만들기

예제 2: 사용자 지정 템플릿 개체 및 매개 변수 파일을 사용하여 배포 만들기

예제 3

예제 4: URI 및 SAS 토큰을 사용하여 공용이 아닌 스토리지 계정에 저장된 템플릿 배포

예제 5: .bicepparam 파일을 사용하여 배포 만들기

매개 변수

-AsJob

-AuxTenant

-Confirm

-DefaultProfile

-DeploymentDebugLogLevel

-Force

-Mode

-Name

-Pre

-ProceedIfNoChange

-QueryString

-ResourceGroupName

-RollBackDeploymentName

-RollbackToLastDeployment

-SkipTemplateParameterPrompt

-Tag

-TemplateFile

-TemplateObject

-TemplateParameterFile

-TemplateParameterObject

-TemplateParameterUri

-TemplateSpecId

-TemplateUri

-WhatIf

-WhatIfExcludeChangeType

-WhatIfResultFormat

입력

출력

관련 링크

추가 리소스