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.
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 gli effetti dell'esecuzione del cmdlet. 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 |