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 beendet eine Azure-Ressourcengruppenbereitstellung, die gestartet wurde, aber nicht abgeschlossen wurde. Um eine Bereitstellung zu beenden, muss die Bereitstellung über einen unvollständigen Bereitstellungszustand verfügen, z. B. Bereitstellungsstatus 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 einen Datenbankserver. Eine Ressourcengruppe ist eine Sammlung von Ressourcen, die als Einheit bereitgestellt werden. Verwenden Sie zum Bereitstellen einer Ressourcengruppe das Cmdlet New-AzResourceGroupDeployment. 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 " auslassen, sucht Stop-AzResourceGroupDeployment nach einer ausgeführten Bereitstellung und beendet sie. Wenn das Cmdlet mehr als eine ausgeführte Bereitstellung 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
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnement, die für die Kommunikation mit Azure verwendet werden

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
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
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
Accept pipeline input:	True
Accept wildcard characters:	False

-Pre

Gibt an, dass dieses Cmdlet Vorabversions-API-Versionen berücksichtigt, wenn sie automatisch bestimmt, welche Version verwendet werden soll.

Type:	SwitchParameter
Position:	Named
Default value:	None
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
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
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

String

Ausgaben

Boolean