Краткое руководство. Создание настраиваемого поставщика ресурсов Azure с помощью Azure PowerShell

Из этого краткого руководства вы узнаете, как создать собственный настраиваемый поставщик ресурсов Azure с помощью модуля PowerShell Az.CustomProviders.

Внимание!

В настоящее время настраиваемые поставщики Azure находятся в общедоступной предварительной версии. Эта предварительная версия предоставляется без соглашения об уровне обслуживания. Эта версия не рекомендуется для использования с рабочими нагрузками в производственной среде. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены. Дополнительные сведения см. в статье Дополнительные условия использования предварительных выпусков Microsoft Azure.

Требования

Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начинать работу.

Если вы решили использовать PowerShell локально, для работы с этой статьей установите модуль PowerShell Az и подключитесь к учетной записи Azure с помощью командлета Connect-AzAccount. См. сведения об установке модуля Azure PowerShell. Если вы решили использовать Cloud Shell, дополнительные сведения см. в статье Обзор Azure Cloud Shell.

Важно!

Так как модуль PowerShell Az.CustomProviders предоставляется в режиме предварительной версии, его нужно установить отдельно с помощью командлета Install-Module. Как только этот модуль PowerShell станет общедоступным, он будет включен в один из будущих выпусков Az PowerShell и встроен в Azure Cloud Shell.

Install-Module -Name Az.CustomProviders

Если вы используете несколько подписок Azure, выберите ту, за ресурсы в которой будут выставляться счета. Выберите требуемую подписку с помощью командлета Set-AzContext.

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

Создание группы ресурсов

Создайте группу ресурсов Azure с помощью командлета New-AzResourceGroup. Группа ресурсов — это логический контейнер, в котором ресурсы Azure развертываются и администрируются как группа.

В следующем примере создается группа ресурсов с указанным именем в выбранном регионе.

New-AzResourceGroup -Name myResourceGroup -Location westus2

Создание настраиваемого поставщика ресурсов

Чтобы создать или обновить настраиваемый поставщик ресурсов, используйте командлет New-AzCustomProvider, как показано в следующем примере.

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

Получение манифеста настраиваемого поставщика ресурсов

Чтобы получить сведения о манифесте настраиваемого поставщика ресурсов, используйте командлет Get-AzCustomProvider, как показано в следующем примере.

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

Создание ассоциации

Чтобы создать или обновить ассоциацию, используйте командлет New-AzCustomProviderAssociation, как показано в следующем примере.

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

Получение ассоциации

Чтобы получить сведения об ассоциации, используйте командлет Get-AzCustomProviderAssociation, как показано в следующем примере.

Get-AzCustomProviderAssociation -Scope $resourceId -Name MyAssoc

Очистка ресурсов

Если созданные при работе с этой статьей ресурсы не нужны, их можно удалить с помощью команды из следующего примера.

Удаление ассоциации

Чтобы удалить ассоциацию, используйте командлет Remove-AzCustomProviderAssociation. В следующем примере удаляется ассоциация.

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

Удаление настраиваемого поставщика ресурсов

Чтобы удалить настраиваемый поставщик ресурсов, используйте командлет Remove-AzCustomProvider. В следующем примере удаляется настраиваемый поставщик ресурсов.

Remove-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type

удаление группы ресурсов.

Внимание!

Следующий пример удаляет указанную группу ресурсов и все содержащиеся в ней ресурсы. Если в указанной группе ресурсов существуют другие ресурсы, кроме созданных для этой статьи, они также будут удалены.

Remove-AzResourceGroup -Name myResourceGroup

Дальнейшие действия

Дополнительные сведения о настраиваемых поставщиках ресурсов Azure см. здесь.