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 リソース グループ内のデプロイを取得します。 結果をフィルター処理する 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 |
| 規定値: | 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を参照してください。