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 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
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.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| 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 Ressourcengruppenbereitstellung an, die beendet werden soll.
| Typ: | String |
| Aliase: | DeploymentId, ResourceId |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | String |
| Aliase: | DeploymentName |
| Position: | 1 |
| Standardwert: | None |
| Erforderlich: | True |
| 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 der Ressourcengruppe an. Dieses Cmdlet beendet die Bereitstellung der Ressourcengruppe, die dieser Parameter angibt.
| Typ: | String |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None