빠른 시작: Azure PowerShell을 사용하여 Azure 사용자 지정 리소스 공급자 만들기

아티클
05/11/2023

이 빠른 시작에서는 Az.CustomProviders PowerShell 모듈을 사용하여 사용자 고유의 Azure 사용자 지정 리소스 공급자를 만드는 방법에 대해 알아봅니다.

주의

Azure 사용자 지정 리소스 공급자는 현재 퍼블릭 미리 보기 상태입니다. 이 미리 보기 버전은 서비스 수준 계약 없이 제공됩니다. 프로덕션 워크로드에는 권장되지 않습니다. 특정 기능이 지원되지 않거나 기능이 제한될 수 있습니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.

요구 사항

Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.

PowerShell을 로컬로 사용하도록 선택하는 경우 이 문서에서는 Az PowerShell 모듈을 설치하고 Connect-AzAccount cmdlet을 사용하여 Azure 계정에 연결해야 합니다. Az PowerShell 모듈을 설치하는 방법에 대한 자세한 내용은 Azure PowerShell 설치를 참조하세요. Cloud Shell을 사용하도록 선택하는 경우 자세한 내용은 Azure Cloud Shell 개요를 참조하세요.

Important

Az.CustomProviders PowerShell 모듈은 미리 보기 상태이지만 Install-Module cmdlet을 사용하여 별도로 설치해야 합니다. 이 PowerShell 모듈이 일반 공급되면 이후 Az PowerShell 모듈 릴리스의 기능으로 포함되어 Azure Cloud Shell 내에서 기본적으로 사용할 수 있습니다.

Install-Module -Name Az.CustomProviders

여러 Azure 구독이 있는 경우 리소스에 대한 요금이 청구되는 적절한 구독을 선택합니다. Set-AzContext cmdlet을 사용하여 특정 구독을 선택합니다.

Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000

리소스 그룹 만들기

New-AzResourceGroup cmdlet을 사용하여 Azure 리소스 그룹을 만듭니다. 리소스 그룹은 Azure 리소스가 그룹으로 배포되고 관리되는 논리 컨테이너입니다.

다음 예제에서는 지정된 이름으로 지정된 위치에 리소스 그룹을 만듭니다.

New-AzResourceGroup -Name myResourceGroup -Location westus2

사용자 지정 리소스 공급자 만들기

사용자 지정 리소스 공급자를 만들거나 업데이트하려면 다음 예제와 같이 New-AzCustomProvider cmdlet을 사용합니다.

New-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type -Location westus2 -ResourceType @{Name='CustomRoute1'; Endpoint='https://www.contoso.com/'}

사용자 지정 리소스 공급자 매니페스트 가져오기

사용자 지정 리소스 공급자 매니페스트에 대한 정보를 검색하려면 다음 예제와 같이 Get-AzCustomProvider cmdlet을 사용합니다.

Get-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type | Format-List

연결 만들기

연결을 만들거나 업데이트하려면 다음 예제와 같이 New-AzCustomProviderAssociation cmdlet을 사용합니다.

$provider = Get-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type
New-AzCustomProviderAssociation -Scope $resourceId -Name MyAssoc -TargetResourceId $provider.Id

연결 가져오기

연결에 대한 정보를 검색하려면 다음 예제와 같이 Get-AzCustomProviderAssociation cmdlet을 사용합니다.

Get-AzCustomProviderAssociation -Scope $resourceId -Name MyAssoc

리소스 정리

이 문서에서 만든 리소스가 필요하지 않은 경우 다음 예제를 실행하여 삭제할 수 있습니다.

연결 삭제

연결을 제거하려면 Remove-AzCustomProviderAssociation cmdlet을 사용합니다. 다음 예제에서는 연결을 삭제합니다.

Remove-AzCustomProviderAssociation -Scope $id -Name Namespace.Type

사용자 지정 리소스 공급자 삭제

사용자 지정 리소스 공급자를 제거하려면 Remove-AzCustomProvider cmdlet을 사용합니다. 다음 예제에서는 사용자 지정 리소스 공급자를 삭제합니다.

Remove-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type

리소스 그룹 삭제

주의

다음 예제에서는 지정된 리소스 그룹과 해당 그룹에 포함된 모든 리소스를 삭제합니다. 지정된 리소스 그룹에 이 문서의 범위에 속하지 않는 리소스가 포함된 경우에도 해당 리소스가 삭제됩니다.

Remove-AzResourceGroup -Name myResourceGroup

다음 단계

Azure 사용자 지정 리소스 공급자에 대해 자세히 알아봅니다.