Inicio rápido: Creación de un proveedor de recursos personalizado de Azure con Azure PowerShell

En esta guía de inicio rápido, aprenderá a crear su propio proveedor de recursos personalizado de Azure mediante el módulo Az.CustomProviders de PowerShell.

Precaución

La característica Proveedores personalizados de Azure está actualmente en versión preliminar pública. Esta versión preliminar se proporciona sin un acuerdo de nivel de servicio. No se recomienda para las cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios de las Versiones Preliminares de Microsoft Azure.

Requisitos

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Si decide usar PowerShell de forma local, para este artículo es preciso que instale el módulo Az PowerShell y que se conecte a su cuenta de Azure con el cmdlet Connect-AzAccount. Para más información sobre cómo instalar el módulo Az PowerShell, consulte Instalación de Azure PowerShell. Si decide usar Cloud Shell, consulte Introducción a Azure Cloud Shell para más información.

Importante

Aunque el módulo Az.CustomProviders de PowerShell está en versión preliminar, se debe instalar por separado mediante el cmdlet Install-Module. Una vez que este módulo de PowerShell esté disponible con carácter general, formará parte de las futuras versiones del módulo Az PowerShell y estará disponible de forma nativa en Azure Cloud Shell.

Install-Module -Name Az.CustomProviders

Si tiene varias suscripciones a Azure, elija la suscripción adecuada en la que se debe facturar el recurso. Seleccione una suscripción específica con el cmdlet Set-AzContext.

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

Crear un grupo de recursos

Cree un grupo de recursos de Azure con el cmdlet New-AzResourceGroup. Un grupo de recursos es un contenedor lógico en el que se implementan y se administran recursos de Azure como un grupo.

En el ejemplo siguiente se crea un grupo de recursos con el nombre especificado y en la ubicación especificada.

New-AzResourceGroup -Name myResourceGroup -Location westus2

Creación de un proveedor de recursos personalizado

Para crear o actualizar un proveedor de recursos personalizado, use el cmdlet New-AzCustomProvider como se muestra en el ejemplo siguiente.

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

Obtención del manifiesto del proveedor de recursos personalizado

Para recuperar información sobre el manifiesto del proveedor de recursos personalizado, use el cmdlet Get-AzCustomProvider como se muestra en el ejemplo siguiente.

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

Creación de una asociación

Para crear o actualizar una asociación, use el cmdlet New-AzCustomProviderAssociation como se muestra en el ejemplo siguiente.

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

Obtención de una asociación

Para recuperar información sobre una asociación, use el cmdlet Get-AzCustomProviderAssociation como se muestra en el ejemplo siguiente.

Get-AzCustomProviderAssociation -Scope $resourceId -Name MyAssoc

Limpieza de recursos

Si no se necesitan los recursos que se han creado en este artículo, puede eliminarlos con el siguiente comando.

Eliminación de una asociación

Para quitar una asociación, use el cmdlet Remove-AzCustomProviderAssociation. En el ejemplo siguiente se elimina una asociación.

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

Eliminación de un proveedor de recursos personalizado

Para quitar un proveedor de recursos personalizado, use el cmdlet Remove-AzCustomProvider. En el ejemplo siguiente se elimina un proveedor de recursos personalizado.

Remove-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type

Eliminar el grupo de recursos

Precaución

En el ejemplo siguiente se elimina el grupo de recursos especificado y todos los recursos que contiene. Si los recursos que están fuera del ámbito de este artículo existen en el grupo de recursos especificado, también se eliminarán.

Remove-AzResourceGroup -Name myResourceGroup

Pasos siguientes

Obtenga más información sobre los proveedores de recursos personalizados de Azure.