Stop-AzureRmResourceGroupDeployment
Bricht eine Ressourcengruppenbereitstellung 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 weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.
Syntax
Stop-AzureRmResourceGroupDeployment
[-ResourceGroupName] <String>
[-Name] <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Stop-AzureRmResourceGroupDeployment
-Id <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet Stop-AzureRmResourceGroupDeployment bricht eine Azure-Ressourcengruppenbereitstellung ab, die gestartet, aber nicht abgeschlossen wurde. Um eine Bereitstellung zu beenden, muss die Bereitstellung einen unvollständigen Bereitstellungsstatus aufweisen, z. B. "Bereitstellung" und keinen abgeschlossenen Zustand, z. B. "Bereitgestellt" oder "Fehlgeschlagen". Eine Azure-Ressource ist eine vom Benutzer verwaltete Entität, z. B. eine Website, Eine Datenbank oder ein Datenbankserver. Eine Ressourcengruppe ist eine Sammlung von Ressourcen, die als Einheit bereitgestellt werden. Verwenden Sie zum Bereitstellen einer Ressourcengruppe das Cmdlet New-AzureRmResourceGroupDeployment. Das Cmdlet New-AzureRmResource erstellt eine neue Ressource, löst jedoch keinen Ressourcengruppenbereitstellungsvorgang aus, den dieses Cmdlet beenden kann. Dieses Cmdlet beendet nur eine ausgeführte Bereitstellung. Verwenden Sie den Parameter Name , um eine bestimmte Bereitstellung zu beenden. Wenn Sie den Parameter Name weglassen, sucht Stop-AzureRmResourceGroupDeployment nach einer ausgeführten Bereitstellung und beendet sie. Wenn das Cmdlet mehrere ausgeführte Bereitstellungen findet, schlägt der Befehl fehl.
Beispiele
Beispiel 1: Starten und Beenden einer Ressourcengruppenbereitstellung
PS C:\> New-AzureRmResourceGroupDeployment -Name mynewstorageaccount -ResourceGroupName myrg -TemplateFile .\storage-account-create-azuredeploy.json -TemplateParameterFile .\storage-account-create-azuredeploy.parameters.json -AsJob
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Long Running... AzureLongRun... Running True localhost New-AzureRmResourceGro...
PS C:\> Stop-AzureRmResourceGroupDeployment -Name mynewstorageaccount -ResourceGroupName myrg
True
PS C:\> Get-Job 1
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Long Running... AzureLongRun... Failed True localhost New-AzureRmResourceGro...Parameter
-ApiVersion
Gibt die API-Version an, die vom Ressourcenanbieter unterstützt wird. Sie können eine andere Version als die Standardversion angeben.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Gibt die ID der Ressourcengruppenbereitstellung an, die beendet werden soll.
| 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 Ressourcengruppenbereitstellung an, die beendet werden soll. Wenn Sie diesen Parameter nicht angeben, sucht dieses Cmdlet nach einer ausgeführten Bereitstellung in der Ressourcengruppe und beendet ihn. Wenn mehr als eine ausgeführte Bereitstellung gefunden wird, schlägt der Befehl fehl. Verwenden Sie das Cmdlet Get-AzureRmResourceGroupDeployment, um den Bereitstellungsnamen abzurufen.
| Type: | String |
| Aliases: | DeploymentName |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| 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 der Ressourcengruppe an. Dieses Cmdlet beendet die Bereitstellung der Ressourcengruppe, die dieser Parameter angibt.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
None