Condividi tramite


Get-AzureRmResourceGroupDeployment

Ottiene le distribuzioni in un gruppo di risorse.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Get-AzureRmResourceGroupDeployment
   [-ResourceGroupName] <String>
   [[-Name] <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmResourceGroupDeployment
   -Id <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-AzureRmResourceGroupDeployment ottiene le distribuzioni in un gruppo di risorse di Azure. Specificare il parametro Name o Id per filtrare i risultati. Per impostazione predefinita, Get-AzureRmResourceGroupDeployment ottiene tutte le distribuzioni per un gruppo di risorse specificato. Una risorsa di Azure è un'entità di Azure gestita dall'utente, ad esempio un server di database, un database o un sito Web. Un gruppo di risorse di Azure è una raccolta di risorse di Azure distribuite come unità. Una distribuzione è l'operazione che rende disponibili le risorse nel gruppo di risorse per l'uso. Per altre informazioni sulle risorse di Azure e sui gruppi di risorse di Azure, vedere il cmdlet New-AzureRmResourceGroup. È possibile usare questo cmdlet per il rilevamento. Per il debug, usare questo cmdlet con il cmdlet Get-AzureRmLog.

Esempio

Esempio 1: Ottenere tutte le distribuzioni per un gruppo di risorse

PS C:\>Get-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoLabsRG"

Questo comando ottiene tutte le distribuzioni per il gruppo di risorse ContosoLabsRG. L'output mostra una distribuzione per un blog wordPress che usa un modello di raccolta.

Esempio 2: Ottenere una distribuzione in base al nome

PS C:\>Get-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoLabsRG" -Name "DeployWebsite01"

Questo comando ottiene la distribuzione DeployWebsite01 del gruppo di risorse ContosoLabsRG. È possibile assegnare un nome a una distribuzione quando lo si crea usando i cmdlet New-AzureRmResourceGroup o New-AzureRmResourceGroupDeployment . Se non si assegna un nome, i cmdlet forniscono un nome predefinito basato sul modello usato per creare la distribuzione.

Esempio 3: Ottenere le distribuzioni di tutti i gruppi di risorse

PS C:\>Get-AzureRmResourceGroup | Get-AzureRmResourceGroupDeployment | Format-Table ResourceGroupName, DeploymentName, ProvisioningState

Questo comando ottiene tutti i gruppi di risorse nella sottoscrizione usando il cmdlet Get-AzureRmResourceGroup. Il comando passa i gruppi di risorse al cmdlet corrente usando l'operatore pipeline. Il cmdlet corrente ottiene tutte le distribuzioni di tutti i gruppi di risorse nella sottoscrizione e passa i risultati al cmdlet Format-Table per visualizzare i valori della proprietà ResourceGroupName, DeploymentName e ProvisioningState .

Parametri

-ApiVersion

Specifica la versione dell'API supportata dal provider di risorse. È possibile specificare una versione diversa rispetto alla versione predefinita.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specifica l'ID della distribuzione del gruppo di risorse da ottenere.

Tipo:String
Alias:DeploymentId, ResourceId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome della distribuzione da ottenere. I caratteri jolly non sono consentiti.

Tipo:String
Alias:DeploymentName
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Pre

Indica che questo cmdlet considera le versioni api non definitive quando determina automaticamente la versione da usare.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceGroupName

Specifica il nome di un gruppo di risorse. Il cmdlet ottiene le distribuzioni per il gruppo di risorse specificato da questo parametro. I caratteri jolly non sono consentiti. Questo parametro è obbligatorio ed è possibile specificare un solo gruppo di risorse in ogni comando.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

None

Output

Microsoft.Azure.Commands.ResourceManagement.Models. PSResourceGroupDeployment