Get-AzResourceGroupDeployment

  • リファレンス
モジュール:
Az.Resources

リソース グループ内のデプロイを取得します。

構文

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 との通信に使用される資格情報、アカウント、テナント、サブスクリプション

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

取得するリソース グループデプロイの ID を指定します。

Type:String
Aliases:DeploymentId, ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

取得するデプロイの名前を指定します。 ワイルドカード文字は使用できません。

Type:String
Aliases:DeploymentName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Pre

このコマンドレットは、使用するバージョンを自動的に決定するときに、プレリリース API バージョンを考慮することを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

リソース グループの名前を指定します。 このコマンドレットは、このパラメーターが指定するリソース グループのデプロイを取得します。 ワイルドカード文字は使用できません。 このパラメーターは必須であり、各コマンドで指定できるリソース グループは 1 つだけです。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

入力

String

出力

PSResourceGroupDeployment