external help file | Module Name | ms.assetid | online version | schema |
---|---|---|---|---|
Microsoft.Azure.Commands.ResourceManager.Cmdlets.dll-Help.xml |
AzureRM.Resources |
20CB842B-F7A9-4052-85D9-0DF9586D5FEA |
2.0.0 |
Gets the deployments in a resource group.
Get-AzureRmResourceGroupDeployment [-ResourceGroupName] <String> [[-Name] <String>] [-ApiVersion <String>]
[-Pre] [-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
Get-AzureRmResourceGroupDeployment -Id <String> [-ApiVersion <String>] [-Pre]
[-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]
The Get-AzureRmResourceGroupDeployment cmdlet gets the deployments in an Azure resource group. Specify the Name or Id parameter to filter the results. By default, Get-AzureRmResourceGroupDeployment gets all deployments for a specified resource group. An Azure resource is a user-managed Azure entity, such as a database server, database, or web site. An Azure resource group is a collection of Azure resources that are deployed as a unit. A deployment is the operation that makes the resources in the resource group available for use. For more information about Azure resources and Azure resource groups, see the New-AzureRmResourceGroup cmdlet. You can use this cmdlet for tracking. For debugging, use this cmdlet with the Get-AzureRmLog cmdlet.
PS C:\>Get-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoLabsRG"
This command gets all deployments for the ContosoLabsRG resource group. The output shows a deployment for a WordPress blog that used a gallery template.
PS C:\>Get-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoLabsRG" -Name "DeployWebsite01"
This command gets the DeployWebsite01 deployment of the ContosoLabsRG resource group. You can assign a name to a deployment when you create it by using the New-AzureRmResourceGroup or New-AzureRmResourceGroupDeployment cmdlets. If you do not assign a name, the cmdlets provide a default name based on the template that is used to create the deployment.
PS C:\>Get-AzureRmResourceGroup | Get-AzureRmResourceGroupDeployment | Format-Table ResourceGroupName, DeploymentName, ProvisioningState
This command gets all resource groups in your subscription by using the Get-AzureRmResourceGroup cmdlet. The command passes the resource groups to the current cmdlet by using the pipeline operator. The current cmdlet gets all deployments of all resource groups in the subscription, and passes the results to the Format-Table cmdlet to display their ResourceGroupName, DeploymentName, and ProvisioningState property values.
Specifies the API version that is supported by the resource Provider. You can specify a different version than the default version.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
The credentials, account, tenant, and subscription used for communication with azure
Type: Microsoft.Azure.Commands.Common.Authentication.Abstractions.IAzureContextContainer
Parameter Sets: (All)
Aliases: AzureRmContext, AzureCredential
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the ID of the resource group deployment to get.
Type: System.String
Parameter Sets: GetByResourceGroupDeploymentId
Aliases: DeploymentId, ResourceId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the name of the deployment to get. Wildcard characters are not permitted.
Type: System.String
Parameter Sets: GetByResourceGroupDeploymentName
Aliases: DeploymentName
Required: False
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
Indicates that this cmdlet considers pre-release API versions when it automatically determines which version to use.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the name of a resource group. The cmdlet gets the deployments for the resource group that this parameter specifies. Wildcard characters are not permitted. This parameter is required and you can specify only one resource group in each command.
Type: System.String
Parameter Sets: GetByResourceGroupDeploymentName
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
New-AzureRmResourceGroupDeployment
Remove-AzureRmResourceGroupDeployment