Stop-AzureRmResourceGroupDeployment
Anuluje wdrożenie grupy zasobów.
Ostrzeżenie
Moduł AzureRM PowerShell jest 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure
| Typ: | IAzureContextContainer |
| Aliasy: | AzureRmContext, AzureCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Id
Określa identyfikator wdrożenia grupy zasobów do zatrzymania.
| Typ: | String |
| Aliasy: | DeploymentId, ResourceId |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Aliasy: | DeploymentName |
| Position: | 1 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Pre
Wskazuje, że to polecenie cmdlet uwzględnia wersje interfejsu API wersji wstępnej, gdy automatycznie określa wersję do użycia.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ResourceGroupName
Określa nazwę grupy zasobów. To polecenie cmdlet zatrzymuje wdrażanie grupy zasobów, którą określa ten parametr.
| Typ: | String |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
None