New-AzureRmResourceGroupDeployment

모듈:

AzureRM.Resources

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

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 유지 관리되거나 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

구문

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateParameterObject <Hashtable>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateParameterObject <Hashtable>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateParameterFile <String>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateParameterFile <String>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateParameterUri <String>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateParameterUri <String>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

예제

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

PS C:\>New-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json"

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

매개 변수

-ApiVersion

리소스 공급자가 지원하는 API 버전을 지정합니다. 기본 버전과 다른 버전을 지정할 수 있습니다.

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

-AsJob

백그라운드에서 cmdlet 실행

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

-Confirm

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

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

-DefaultProfile

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

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

-DeploymentDebugLogLevel

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

• RequestContent
• ResponseContent
• 모두
• None

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

-Force

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

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

-Mode

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

• Complete
• 증분 전체 모드에서 Resource Manager는 리소스 그룹에 있지만 템플릿에 지정되지 않은 리소스를 삭제합니다. 증분 모드에서는 Resource Manager가 리소스 그룹에 존재하지만 템플릿에는 지정되지 않은 리소스를 변경하지 않고 유지합니다.

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

-Name

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

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

-Pre

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

형식:	SwitchParameter
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

-TemplateFile

JSON 템플릿 파일의 전체 경로를 지정합니다. 이 템플릿은 Save-AzureRmResourceGroupGalleryTemplate cmdlet을 사용하여 만든 템플릿과 같이 JSON 파일로 저장되는 사용자 지정 템플릿 또는 갤러리 템플릿일 수 있습니다.

형식:	String
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를 지정합니다.

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

-TemplateUri

JSON 템플릿 파일의 URI를 지정합니다. 이 파일은 Save-AzureRmResourceGroupGalleryTemplate을 사용하는 것과 같이 JSON 파일로 저장되는 사용자 지정 템플릿 또는 갤러리 템플릿일 수 있습니다.

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

-WhatIf

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

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

입력

None

출력

Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment

관련 링크

• Get-AzureRmResourceGroupDeployment
• New-AzureRmResource
• New-AzureRmResourceGroup
• Remove-AzureRmResourceGroupDeployment
• Stop-AzureRmResourceGroupDeployment
• Test-AzureRmResourceGroupDeployment