Stop-AzResourceGroupDeployment

Annulla una distribuzione di un gruppo di risorse.

Sintassi

Stop-AzResourceGroupDeployment
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-AzResourceGroupDeployment
    -Id <String>
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Stop-AzResourceGroupDeployment annulla una distribuzione del gruppo di risorse di Azure avviata ma non completata. Per arrestare una distribuzione, la distribuzione deve avere uno stato di provisioning incompleto, ad esempio Provisioning e non stato completato, ad esempio Provisioning o Non riuscito. Una risorsa di Azure è un'entità gestita dall'utente, ad esempio un sito Web, un database o un server di database. Un gruppo di risorse è una raccolta di risorse distribuite come unità. Per distribuire un gruppo di risorse, usare il cmdlet New-AzResourceGroupDeployment. Il cmdlet New-AzResource crea una nuova risorsa, ma non attiva un'operazione di distribuzione del gruppo di risorse che questo cmdlet può arrestare. Questo cmdlet arresta una sola distribuzione in esecuzione. Usare il parametro Name per arrestare una distribuzione specifica. Se si omette il parametro Name , Stop-AzResourceGroupDeployment cerca una distribuzione in esecuzione e la arresta. Se il cmdlet trova più distribuzioni in esecuzione, il comando ha esito negativo.

Esempio

Esempio 1: Avvio e arresto di una distribuzione di un gruppo di risorse

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

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

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

-Id

Specifica l'ID della distribuzione del gruppo di risorse da arrestare.

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

-Name

Specifica il nome della distribuzione del gruppo di risorse da arrestare. Se non si specifica questo parametro, questo cmdlet cerca una distribuzione in esecuzione nel gruppo di risorse e la arresta. Se trova più distribuzioni in esecuzione, il comando ha esito negativo. Per ottenere il nome della distribuzione, usare il cmdlet Get-AzResourceGroupDeployment.

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

-Pre

Indica che questo cmdlet considera le versioni api non definitive quando determina automaticamente la versione da usare.

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

-ResourceGroupName

Specifica il nome del gruppo di risorse. Questo cmdlet arresta la distribuzione del gruppo di risorse specificato da questo parametro.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

String

Output

Boolean