Get-AzResourceGroupDeployment

Referenz

Modul:: Az.Resources

Ruft die Bereitstellungen in einer Ressourcengruppe ab.

Syntax

Get-AzResourceGroupDeployment
   [-ResourceGroupName] <String>
   [[-Name] <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzResourceGroupDeployment
   -Id <String>
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-AzResourceGroupDeployment ruft die Bereitstellungen in einer Azure-Ressourcengruppe ab. Geben Sie den Parameter Name oder ID an, um die Ergebnisse zu filtern. Standardmäßig ruft Get-AzResourceGroupDeployment alle Bereitstellungen für eine angegebene Ressourcengruppe ab. Eine Azure-Ressource ist eine vom Benutzer verwaltete Azure-Entität, z. B. ein Datenbankserver, eine Datenbank oder eine Website. Eine Azure-Ressourcengruppe ist eine Sammlung von Azure-Ressourcen, die als Einheit bereitgestellt werden. Eine Bereitstellung ist der Vorgang, der die Ressourcen in der Ressourcengruppe zur Verwendung zur Verfügung stellt. Weitere Informationen zu Azure-Ressourcen und Azure-Ressourcengruppen finden Sie im Cmdlet New-AzResourceGroup. Sie können dieses Cmdlet für die Nachverfolgung verwenden. Verwenden Sie für das Debuggen dieses Cmdlets mit dem Cmdlet "Get-AzLog".

Beispiele

Beispiel 1: Abrufen aller Bereitstellungen für eine Ressourcengruppe

Get-AzResourceGroupDeployment -ResourceGroupName "ContosoLabsRG"

Dieser Befehl ruft alle Bereitstellungen für die ContosoLabsRG-Ressourcengruppe ab. Die Ausgabe zeigt eine Bereitstellung für einen WordPress-Blog, der eine Katalogvorlage verwendet hat.

Beispiel 2: Abrufen einer Bereitstellung anhand des Namens

Get-AzResourceGroupDeployment -ResourceGroupName "ContosoLabsRG" -Name "DeployWebsite01"

Dieser Befehl ruft die DeployWebsite01-Bereitstellung der ContosoLabsRG-Ressourcengruppe ab. Sie können einer Bereitstellung einen Namen zuweisen, wenn Sie ihn erstellen, indem Sie die Cmdlets New-AzResourceGroup oder New-AzResourceGroupDeployment verwenden. Wenn Sie keinen Namen zuweisen, geben die Cmdlets basierend auf der Vorlage, die zum Erstellen der Bereitstellung verwendet wird, einen Standardnamen an.

Beispiel 3: Abrufen der Bereitstellungen aller Ressourcengruppen

Get-AzResourceGroup | Get-AzResourceGroupDeployment | Format-Table ResourceGroupName, DeploymentName, ProvisioningState

Mit diesem Befehl werden alle Ressourcengruppen in Ihrem Abonnement mithilfe des Cmdlets "Get-AzResourceGroup" abgerufen. Der Befehl übergibt die Ressourcengruppen mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet ruft alle Bereitstellungen aller Ressourcengruppen im Abonnement ab und übergibt die Ergebnisse an das Cmdlet "Format-Table", um die Eigenschaftswerte "ResourceGroupName", "DeploymentName" und "ProvisioningState" anzuzeigen.

Parameter

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Gibt die ID der abzurufenden Ressourcengruppenbereitstellung an.

Type:	String
Aliases:	DeploymentId, ResourceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Gibt den Namen der abzurufenden Bereitstellung an. Platzhalterzeichen sind nicht zulässig.

Type:	String
Aliases:	DeploymentName
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Pre

Gibt an, dass dieses Cmdlet vorab veröffentlichte API-Versionen berücksichtigt, wenn es automatisch bestimmt, welche Version verwendet werden soll.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Gibt den Namen einer Ressourcengruppe an. Das Cmdlet ruft die Bereitstellungen für die Ressourcengruppe ab, die dieser Parameter angibt. Platzhalterzeichen sind nicht zulässig. Dieser Parameter ist erforderlich, und Sie können nur eine Ressourcengruppe in jedem Befehl angeben.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Eingaben

String

Ausgaben

PSResourceGroupDeployment