Stop-AzureRmResourceGroupDeployment
Hiermee annuleert u de implementatie van een resourcegroep.
Waarschuwing
De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.
Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.
Syntaxis
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
De cmdlet Stop-AzureRmResourceGroupDeployment annuleert een implementatie van een Azure-resourcegroep die is gestart, maar niet is voltooid. Als u een implementatie wilt stoppen, moet de implementatie een onvolledige inrichtingsstatus hebben, zoals Inrichten en geen voltooide status, zoals Ingericht of Mislukt. Een Azure-resource is een door de gebruiker beheerde entiteit, zoals een website, database of databaseserver. Een resourcegroep is een verzameling resources die als een eenheid worden geïmplementeerd. Als u een resourcegroep wilt implementeren, gebruikt u de cmdlet New-AzureRmResourceGroupDeployment. Met de cmdlet New-AzureRmResource wordt een nieuwe resource gemaakt, maar er wordt geen implementatiebewerking voor een resourcegroep geactiveerd die door deze cmdlet kan worden gestopt. Met deze cmdlet wordt slechts één actieve implementatie gestopt. Gebruik de parameter Name om een specifieke implementatie te stoppen. Als u de parameter Name weglaat, zoekt Stop-AzureRmResourceGroupDeployment naar een actieve implementatie en stopt u deze. Als de cmdlet meer dan één actieve implementatie vindt, mislukt de opdracht.
Voorbeelden
Voorbeeld 1: Een implementatie van een resourcegroep starten en stoppen
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...
Parameters
-ApiVersion
Hiermee geeft u de API-versie op die wordt ondersteund door de resourceprovider. U kunt een andere versie opgeven dan de standaardversie.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliassen: | cf |
Position: | Named |
Default value: | False |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DefaultProfile
De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure
Type: | IAzureContextContainer |
Aliassen: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Id
Hiermee geeft u de id van de implementatie van de resourcegroep op die moet worden gestopt.
Type: | String |
Aliassen: | DeploymentId, ResourceId |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Name
Hiermee geeft u de naam van de implementatie van de resourcegroep op die moet worden gestopt. Als u deze parameter niet opgeeft, zoekt deze cmdlet naar een actieve implementatie in de resourcegroep en stopt deze. Als er meer dan één actieve implementatie wordt gevonden, mislukt de opdracht. Gebruik de cmdlet Get-AzureRmResourceGroupDeployment om de implementatienaam op te halen.
Type: | String |
Aliassen: | DeploymentName |
Position: | 1 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Pre
Hiermee wordt aangegeven dat deze cmdlet api-versies van de voorlopige versie beschouwt wanneer deze automatisch bepaalt welke versie moet worden gebruikt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ResourceGroupName
Hiermee geeft u de naam van de resourcegroep. Deze cmdlet stopt de implementatie van de resourcegroep die met deze parameter wordt opgegeven.
Type: | String |
Position: | 0 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliassen: | wi |
Position: | Named |
Default value: | False |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Invoerwaarden
None