Get-AzResourceGroupDeployment
リソース グループ内のデプロイを取得します。
構文
Get-AzResourceGroupDeployment
[-ResourceGroupName] <String>
[[-Name] <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeployment
-Id <String>
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Get-AzResourceGroupDeployment コマンドレットは、Azure リソース グループ内のデプロイを取得します。 結果をフィルター処理するには、 Name または Id パラメーターを指定します。 既定では、 Get-AzResourceGroupDeployment は、指定されたリソース グループのすべてのデプロイを取得します。 Azure リソースは、データベース サーバー、データベース、Web サイトなど、ユーザーが管理する Azure エンティティです。 Azure リソース グループは、ユニットとしてデプロイされる Azure リソースのコレクションです。 デプロイとは、リソース グループ内のリソースを使用できるようにする操作です。 Azure リソースと Azure リソース グループの詳細については、New-AzResourceGroup コマンドレットを参照してください。 このコマンドレットは追跡に使用できます。 デバッグの場合は、Get-AzLog コマンドレットでこのコマンドレットを使用します。
例
例 1: リソース グループのすべてのデプロイを取得する
Get-AzResourceGroupDeployment -ResourceGroupName "ContosoLabsRG"
このコマンドは、ContosoLabsRG リソース グループのすべてのデプロイを取得します。 出力には、ギャラリー テンプレートを使用した WordPress ブログの展開が表示されます。
例 2: 名前でデプロイを取得する
Get-AzResourceGroupDeployment -ResourceGroupName "ContosoLabsRG" -Name "DeployWebsite01"
このコマンドは、ContosoLabsRG リソース グループの DeployWebsite01 デプロイを取得します。 New-AzResourceGroup または New-AzResourceGroupDeployment コマンドレットを使用して、デプロイを作成するときにデプロイに名前を割り当てることができます。 名前を割り当てない場合、コマンドレットはデプロイの作成に使用されるテンプレートに基づいて既定の名前を提供します。
例 3: すべてのリソース グループのデプロイを取得する
Get-AzResourceGroup | Get-AzResourceGroupDeployment | Format-Table ResourceGroupName, DeploymentName, ProvisioningState
このコマンドは、Get-AzResourceGroup コマンドレットを使用して、サブスクリプション内のすべてのリソース グループを取得します。 このコマンドは、パイプライン 演算子を使用して、リソース グループを現在のコマンドレットに渡します。 現在のコマンドレットは、サブスクリプション内のすべてのリソース グループのすべてのデプロイを取得し、結果を Format-Table コマンドレットに渡して、 ResourceGroupName、 DeploymentName、および ProvisioningState プロパティ値を表示します。
パラメーター
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
型: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Id
取得するリソース グループデプロイの ID を指定します。
型: | String |
Aliases: | DeploymentId, ResourceId |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
取得するデプロイの名前を指定します。 ワイルドカード文字は使用できません。
型: | String |
Aliases: | DeploymentName |
配置: | 1 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Pre
このコマンドレットは、使用するバージョンを自動的に決定するときに、プレリリース API バージョンを考慮することを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
リソース グループの名前を指定します。 このコマンドレットは、このパラメーターが指定するリソース グループのデプロイを取得します。 ワイルドカード文字は使用できません。 このパラメーターは必須であり、各コマンドで指定できるリソース グループは 1 つだけです。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |