Stop-AzResourceGroupDeployment

  • Referenz
Modul:
Az.Resources

Bricht eine Ressourcengruppenbereitstellung ab.

Syntax

Stop-AzResourceGroupDeployment
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-AzResourceGroupDeployment
    -Id <String>
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Stop-AzResourceGroupDeployment 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 das Cmdlet New-AzResourceGroupDeployment, um eine Ressourcengruppe bereitzustellen. Das Cmdlet New-AzResource 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-AzResourceGroupDeployment 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

New-AzResourceGroupDeployment -Name mynewstorageaccount -ResourceGroupName myrg -TemplateFile .\storage-account-create-azdeploy.json -TemplateParameterFile .\storage-account-create-azdeploy.parameters.json -AsJob

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
1      Long Running... AzureLongRun... Running       True            localhost            New-AzResourceGro...

Stop-AzResourceGroupDeployment -Name mynewstorageaccount -ResourceGroupName myrg

True

Get-Job 1

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
1      Long Running... AzureLongRun... Failed        True            localhost            New-AzResourceGro...

Parameter

-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:AzContext, 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 zum Abrufen des Bereitstellungsnamens das Cmdlet "Get-AzResourceGroupDeployment".

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

String

Ausgaben

Boolean