Condividi tramite

Stop-AzResourceGroupDeployment

  • Riferimento
Modulo:
Az.Resources

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

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

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

Tipo:String
Alias:DeploymentId, ResourceId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String
Alias:DeploymentName
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Pre

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceGroupName

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

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

Output

Boolean