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 de recursos 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.