Get-AzResourceGroupDeployment
Obtém as implantações em um grupo de recursos.
Sintaxe
GetByResourceGroupDeploymentName (Default)
Get-AzResourceGroupDeployment
[-ResourceGroupName] <String>
[[-Name] <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetByResourceGroupDeploymentId
Get-AzResourceGroupDeployment
-Id <String>
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet Get-AzResourceGroupDeployment obtém as implantações em um grupo de recursos do Azure. Especifique o parâmetro Nome ou ID para filtrar os resultados. Por padrão, Get-AzResourceGroupDeployment obtém todas as implantações de um grupo de recursos especificado. Um recurso do Azure é uma entidade do Azure gerenciada pelo usuário, como um servidor de banco de dados, um banco de dados ou um site da Web. Um grupo de recursos do Azure é uma coleção de recursos do Azure implantados como uma unidade. Uma implantação é a operação que disponibiliza os recursos no grupo de recursos para uso. Para obter mais informações sobre recursos do Azure e grupos de recursos do Azure, consulte o cmdlet New-AzResourceGroup. Você pode usar esse cmdlet para acompanhamento. Para depuração, use este cmdlet com o cmdlet Get-AzLog.
Exemplos
Exemplo 1: Obter todas as implantações para um grupo de recursos
Get-AzResourceGroupDeployment -ResourceGroupName "ContosoLabsRG"
Esse comando obtém todas as implantações para o grupo de recursos ContosoLabsRG. A saída mostra uma implantação para um blog do WordPress que usou um modelo de galeria.
Exemplo 2: Obter uma implantação por nome
Get-AzResourceGroupDeployment -ResourceGroupName "ContosoLabsRG" -Name "DeployWebsite01"
Esse comando obtém a implantação DeployWebsite01 do grupo de recursos ContosoLabsRG. Você pode atribuir um nome a uma implantação ao criá-la usando os cmdlets New-AzResourceGroup ou New-AzResourceGroupDeployment . Se você não atribuir um nome, os cmdlets fornecerão um nome padrão com base no modelo usado para criar a implantação.
Exemplo 3: Obter as implantações de todos os grupos de recursos
Get-AzResourceGroup | Get-AzResourceGroupDeployment | Format-Table ResourceGroupName, DeploymentName, ProvisioningState
Esse comando obtém todos os grupos de recursos em sua assinatura usando o cmdlet Get-AzResourceGroup. O comando passa os grupos de recursos para o cmdlet atual usando o operador de pipeline. O cmdlet atual obtém todas as implantações de todos os grupos de recursos na assinatura e passa os resultados para o cmdlet Format-Table para exibir seus valores de propriedade ResourceGroupName, DeploymentName e ProvisioningState .
Parâmetros
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure
Propriedades do parâmetro
| Tipo: | IAzureContextContainer |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Id
Especifica a ID da implantação do grupo de recursos a ser obtido.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | DeploymentId, ResourceId |
Conjuntos de parâmetros
GetByResourceGroupDeploymentId
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Especifica o nome da implantação a ser obtido. Caracteres curinga não são permitidos.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | DeploymentName |
Conjuntos de parâmetros
GetByResourceGroupDeploymentName
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Pre
Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ResourceGroupName
Especifica o nome de um grupo de recursos. O cmdlet obtém as implantações do grupo de recursos especificado por esse parâmetro. Caracteres curinga não são permitidos. Esse parâmetro é necessário e você pode especificar apenas um grupo de recursos em cada comando.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetByResourceGroupDeploymentName
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
