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.

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

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

String

Ausgaben

Boolean