Udostępnij za pośrednictwem


Stop-AzureRmResourceGroupDeployment

Anuluje wdrożenie grupy zasobów.

Ostrzeżenie

Moduł AzureRM PowerShell został oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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>]

Opis

Polecenie cmdlet Stop-AzureRmResourceGroupDeployment anuluje wdrożenie grupy zasobów platformy Azure, które zostało uruchomione, ale nie zostało ukończone. Aby zatrzymać wdrożenie, wdrożenie musi mieć niekompletny stan aprowizacji, taki jak aprowizowanie, a nie stan ukończony, taki jak Aprowizowanie lub Niepowodzenie. Zasób platformy Azure to jednostka zarządzana przez użytkownika, taka jak witryna internetowa, baza danych lub serwer bazy danych. Grupa zasobów to kolekcja zasobów, które są wdrażane jako jednostka. Aby wdrożyć grupę zasobów, użyj polecenia cmdlet New-AzureRmResourceGroupDeployment. Polecenie cmdlet New-AzureRmResource tworzy nowy zasób, ale nie wyzwala operacji wdrażania grupy zasobów, którą to polecenie cmdlet może zatrzymać. To polecenie cmdlet zatrzymuje tylko jedno uruchomione wdrożenie. Użyj parametru Name, aby zatrzymać określone wdrożenie. Jeśli pominięto parametr Name , stop-AzureRmResourceGroupDeployment wyszukuje uruchomione wdrożenie i zatrzymuje je. Jeśli polecenie cmdlet znajdzie więcej niż jedno uruchomione wdrożenie, polecenie zakończy się niepowodzeniem.

Przykłady

Przykład 1. Uruchamianie i zatrzymywanie wdrożenia grupy zasobów

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...

Parametry

-ApiVersion

Określa wersję interfejsu API obsługiwaną przez dostawcę zasobów. Możesz określić inną wersję niż domyślna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Określa identyfikator wdrożenia grupy zasobów do zatrzymania.

Type:String
Aliases:DeploymentId, ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Określa nazwę wdrożenia grupy zasobów do zatrzymania. Jeśli ten parametr nie zostanie określony, to polecenie cmdlet wyszukuje uruchomione wdrożenie w grupie zasobów i zatrzymuje je. Jeśli znajdzie więcej niż jedno uruchomione wdrożenie, polecenie zakończy się niepowodzeniem. Aby uzyskać nazwę wdrożenia, użyj polecenia cmdlet Get-AzureRmResourceGroupDeployment.

Type:String
Aliases:DeploymentName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Pre

Wskazuje, że to polecenie cmdlet uwzględnia wersje interfejsu API wersji wstępnej, gdy automatycznie określa wersję do użycia.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Określa nazwę grupy zasobów. To polecenie cmdlet zatrzymuje wdrażanie grupy zasobów, którą określa ten parametr.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

None

Dane wyjściowe

Boolean