Get-AzResourceGroupDeployment
リソース グループ内のデプロイを取得します。
構文
GetByResourceGroupDeploymentName (既定)
Get-AzResourceGroupDeployment
[-ResourceGroupName] <String>
[[-Name] <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetByResourceGroupDeploymentId
Get-AzResourceGroupDeployment
-Id <String>
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Get-AzResourceGroupDeployment コマンドレットは、Azure リソース グループ内のデプロイを取得します。 結果をフィルター処理するには、名 または 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 |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Id
取得するリソース グループデプロイの ID を指定します。
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | DeploymentId, リソースID |
パラメーター セット
GetByResourceGroupDeploymentId
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Name
取得するデプロイの名前を指定します。 ワイルドカード文字は使用できません。
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | デプロイメント名 |
パラメーター セット
GetByResourceGroupDeploymentName
配置: | 1 |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-Pre
このコマンドレットは、使用するバージョンを自動的に決定するときに、プレリリース API バージョンを考慮することを示します。
パラメーターのプロパティ
型: | SwitchParameter |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ResourceGroupName
リソース グループの名前を指定します。 このコマンドレットは、このパラメーターが指定するリソース グループのデプロイを取得します。 ワイルドカード文字は使用できません。 このパラメーターは必須であり、各コマンドで指定できるリソース グループは 1 つだけです。
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
GetByResourceGroupDeploymentName
配置: | 0 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。