クイックスタート:Azure PowerShell を使用して Azure カスタム リソース プロバイダーを作成する
このクイックスタートでは、Az.CustomProviders PowerShell モジュールを使用して独自の Azure カスタム リソース プロバイダーを作成する方法について説明します。
注意
現在、Azure カスタム リソース プロバイダーはパブリック プレビュー段階です。 このプレビュー バージョンは、サービス レベル アグリーメントなしに提供されます。 運用環境のワークロードにはお勧めしません。 特定の機能はサポート対象ではなく、機能が制限されることがあります。 詳しくは、Microsoft Azure プレビューの追加使用条件に関するページをご覧ください。
必要条件
Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
ローカルで PowerShell を使用する場合は、Az PowerShell モジュールをインストールしたうえで、Connect-AzAccount コマンドレットを使用して自分の Azure アカウントに接続する必要があります。 Az PowerShell モジュールのインストールの詳細については、「Azure PowerShell のインストール」を参照してください。 Cloud Shell の使用を選択した場合、詳細については「Azure Cloud Shell の概要」を参照してください。
重要
Az.CustomProviders PowerShell モジュールがプレビュー段階にある間は、Install-Module
コマンドレットを使用して、これを個別にインストールする必要があります。 この PowerShell モジュールは、一般提供された段階で将来の Az PowerShell モジュール リリースの一部となり、Azure Cloud Shell 内からネイティブに使用できるようになります。
Install-Module -Name Az.CustomProviders
複数の Azure サブスクリプションをお持ちの場合は、リソースが課金の対象となる適切なサブスクリプションを選択してください。 Set-AzContext コマンドレットを使用して、特定のサブスクリプションを選択します。
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
リソース グループを作成する
New-AzResourceGroup コマンドレットを使用して、Azure リソース グループを作成します。 リソース グループとは、複数の 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 カスタム リソース プロバイダーに関するページを参照してください。