Início Rápido: Criar um provedor de recursos personalizado do Azure com o Azure PowerShell

Neste início rápido, você aprenderá a criar um provedor de recursos personalizado do Azure usando o módulo Az.CustomProviders do PowerShell.

Cuidado

No momento, o Azure Custom Providers está em versão prévia pública. A versão prévia é fornecida sem um contrato de nível de serviço. Ela não é recomendada para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares de Versões Prévias do Microsoft Azure.

Requisitos

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Se você optar por usar o PowerShell localmente, este artigo exigirá que você instale o módulo Az PowerShell e conecte-se à sua conta do Azure usando o cmdlet Connect-AzAccount. Para obter mais informações sobre como instalar o módulo Az PowerShell, confira Instalar o Azure PowerShell. Se você optar por usar o Cloud Shell, confira Visão geral do Azure Cloud Shell para obter mais informações.

Importante

Enquanto o módulo Az.CustomProviders do PowerShell estiver em versão prévia, você precisará instalá-lo separadamente usando o cmdlet Install-Module. Quando esse módulo do PowerShell estiver em disponibilidade geral, ele passará a fazer parte das versões futuras do módulo Az PowerShell e estará disponível nativamente no Azure Cloud Shell.

Install-Module -Name Az.CustomProviders

Se tiver várias assinaturas do Azure, escolha a que for adequada para cobrança do recurso. Selecione uma assinatura específica usando o cmdlet Set-AzContext.

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

Criar um grupo de recursos

Crie um grupo de recursos do Azure usando o cmdlet New-AzResourceGroup. Um grupo de recursos é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados como um grupo.

O exemplo a seguir cria um grupo de recursos com o nome especificado no local especificado.

New-AzResourceGroup -Name myResourceGroup -Location westus2

Criar um provedor de recursos personalizado

Para criar ou atualizar um provedor de recursos personalizado, use o cmdlet New-AzCustomProvider, conforme mostrado no exemplo a seguir.

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

Obter o manifesto do provedor de recursos personalizado

Para recuperar informações sobre o manifesto do provedor de recursos personalizado, use o cmdlet Get-AzCustomProvider, conforme mostrado no exemplo a seguir.

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

Criar uma associação

Para criar ou atualizar uma associação, use o cmdlet New-AzCustomProviderAssociation, conforme mostrado no exemplo a seguir.

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

Obter uma associação

Para recuperar informações sobre uma associação, use o cmdlet New-AzCustomProviderAssociation, conforme mostrado no exemplo a seguir.

Get-AzCustomProviderAssociation -Scope $resourceId -Name MyAssoc

Limpar os recursos

Se os recursos criados neste artigo não forem necessários, você poderá excluí-los executando o exemplo a seguir.

Excluir uma associação

Para remover uma associação, use o cmdlet Remove-AzCustomProviderAssociation. O exemplo a seguir exclui uma associação.

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

Excluir um provedor de recursos personalizado

Para remover um provedor de recursos personalizado, use o cmdlet Remove-AzCustomProvider. O exemplo a seguir exclui um provedor de recursos personalizado.

Remove-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type

Exclua o grupo de recursos

Cuidado

O exemplo a seguir exclui o grupo de recursos especificado e todos os recursos contidos nele. Se existirem recursos fora do escopo deste artigo no grupo de recursos especificado, eles também serão excluídos.

Remove-AzResourceGroup -Name myResourceGroup

Próximas etapas

Saiba mais sobre os Provedores de Recursos Personalizados do Azure.