Stop-AzureRmResourceGroupDeployment
Zruší nasazení skupiny prostředků.
Upozorňující
Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
Syntax
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>]
Description
Rutina Stop-AzureRmResourceGroupDeployment zruší nasazení skupiny prostředků Azure, které se spustilo, ale nedokončilo. Pokud chcete zastavit nasazení, musí mít nasazení neúplný stav zřizování, jako je zřizování, a ne dokončený stav, jako je Provisioned nebo Failed. Prostředek Azure je entita spravovaná uživatelem, jako je web, databáze nebo databázový server. Skupina prostředků je kolekce prostředků nasazených jako jednotka. K nasazení skupiny prostředků použijte rutinu New-AzureRmResourceGroupDeployment. Rutina New-AzureRmResource vytvoří nový prostředek, ale neaktivuje operaci nasazení skupiny prostředků, kterou může tato rutina zastavit. Tato rutina zastaví pouze jedno spuštěné nasazení. K zastavení konkrétního nasazení použijte parametr Name . Pokud parametr Name vynecháte, stop-AzureRmResourceGroupDeployment vyhledá spuštěné nasazení a zastaví ho. Pokud rutina najde více než jedno spuštěné nasazení, příkaz selže.
Příklady
Příklad 1: Spuštění a zastavení nasazení skupiny prostředků
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
Určuje verzi rozhraní API podporovanou poskytovatelem prostředků. Můžete zadat jinou verzi, než je výchozí verze.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Typ: | SwitchParameter |
Aliases: | cf |
Position: | Named |
výchozí hodnota: | False |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure
Typ: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Určuje ID nasazení skupiny prostředků, které se má zastavit.
Typ: | String |
Aliases: | DeploymentId, ResourceId |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Určuje název nasazení skupiny prostředků, která se má zastavit. Pokud tento parametr nezadáte, tato rutina vyhledá spuštěné nasazení ve skupině prostředků a zastaví ho. Pokud najde více než jedno spuštěné nasazení, příkaz selže. Pokud chcete získat název nasazení, použijte rutinu Get-AzureRmResourceGroupDeployment.
Typ: | String |
Aliases: | DeploymentName |
Position: | 1 |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Pre
Označuje, že tato rutina bere v úvahu předběžné verze rozhraní API, když automaticky určí, kterou verzi použít.
Typ: | SwitchParameter |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Určuje název skupiny prostředků. Tato rutina zastaví nasazení skupiny prostředků, kterou tento parametr určuje.
Typ: | String |
Position: | 0 |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Typ: | SwitchParameter |
Aliases: | wi |
Position: | Named |
výchozí hodnota: | False |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
None