Get-AzureRmResourceGroupDeployment

  • Referenz
Modul:
AzureRM.Resources

Ruft die Bereitstellungen in einer Ressourcengruppe ab.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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

Beschreibung

Das Cmdlet Get-AzureRmResourceGroupDeployment 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-AzureRmResourceGroupDeployment 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-AzureRmResourceGroup. Sie können dieses Cmdlet für die Nachverfolgung verwenden. Verwenden Sie für das Debuggen dieses Cmdlets mit dem Cmdlet "Get-AzureRmLog".

Beispiele

Beispiel 1: Abrufen aller Bereitstellungen für eine Ressourcengruppe

PS C:\>Get-AzureRmResourceGroupDeployment -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

PS C:\>Get-AzureRmResourceGroupDeployment -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-AzureRmResourceGroup oder New-AzureRmResourceGroupDeployment 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

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

Mit diesem Befehl werden alle Ressourcengruppen in Ihrem Abonnement mithilfe des Cmdlets "Get-AzureRmResourceGroup" 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

-ApiVersion

Gibt die API-Version an, die vom Ressourcenanbieter unterstützt wird. Sie können eine andere Version als die Standardversion angeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Gibt die ID der abzurufenden Ressourcengruppenbereitstellung an.

Typ:String
Aliase:DeploymentId, ResourceId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

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

Typ:String
Aliase:DeploymentName
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Pre

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

Microsoft.Azure.Commands.ResourceManagement.Models. PSResourceGroupDeployment