AzureResourceGroupDeployment@1 – Azure Resource Group Deployment v1-uppgift

Artikel
2025-03-24

Använd den här uppgiften för att distribuera, starta, stoppa och ta bort Azure-resursgrupper.

Den här uppgiften är inaktuell. använd AzureResourceGroupDeployment@2.

Syntax

# Azure Resource Group Deployment v1
# Deploy, start, stop, delete Azure Resource Groups.
- task: AzureResourceGroupDeployment@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameClassic'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Subscription. 
    #ConnectedServiceNameClassic: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Azure Classic Subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'Restart' | 'Delete' | 'DeleteRG'. Required when ConnectedServiceNameSelector = ConnectedServiceName. Action. Default: Create Or Update Resource Group.
    #actionClassic: 'Select Resource Group' # 'Select Resource Group'. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Action. Default: Select Resource Group.
    resourceGroupName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Resource Group. 
    #cloudService: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Cloud Service. 
    #location: 'East US' # 'Australia East' | 'Australia Southeast' | 'Brazil South' | 'Canada Central' | 'Canada East' | 'Central India' | 'Central US' | 'East Asia' | 'East US' | 'East US 2 ' | 'Japan East' | 'Japan West' | 'North Central US' | 'North Europe' | 'South Central US' | 'South India' | 'Southeast Asia' | 'UK South' | 'UK West' | 'West Central US' | 'West Europe' | 'West India' | 'West US' | 'West US 2'. Required when action = Create Or Update Resource Group. Location. Default: East US.
    #csmFile: # string. Required when action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when action = Create Or Update Resource Group. Template Parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override Template Parameters. 
    #deploymentMode: 'Incremental' # 'Validation' | 'Incremental' | 'Complete'. Required when action = Create Or Update Resource Group. Deployment Mode. Default: Incremental.
    #enableDeploymentPrerequisitesForCreate: false # boolean. Optional. Use when action = Create Or Update Resource Group. Enable Deployment Prerequisites. Default: false.
    #enableDeploymentPrerequisitesForSelect: false # boolean. Optional. Use when action = Select Resource Group. Enable Deployment Prerequisites. Default: false.
  # Output
    #outputVariable: # string. Resource Group.

Ingångar

ConnectedServiceNameSelector - Azure-anslutningstyp
string. Tillåtna värden: ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (klassisk Azure). Standardvärde: ConnectedServiceName.

Obligatoriskt. Väljer den tjänstanslutning som innehåller en Azure-prenumeration för distributionen.

ConnectedServiceName - Azure-prenumeration
string. Krävs när ConnectedServiceNameSelector = ConnectedServiceName.

Obligatoriskt. Väljer den tjänstanslutning som innehåller en Azure-prenumeration för distributionen.

ConnectedServiceNameClassic - klassisk Azure-prenumeration
string. Krävs när ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Väljer en klassisk Azure-prenumeration för distributionen.

action - åtgärd
string. Krävs när ConnectedServiceNameSelector = ConnectedServiceName. Tillåtna värden: Create Or Update Resource Group, Select Resource Group, Start (Starta virtuella datorer), Stop (Stoppa virtuella datorer), Restart (Starta om virtuella datorer), Delete (Ta bort virtuella datorer), DeleteRG (Ta bort resursgrupp). Standardvärde: Create Or Update Resource Group.

Åtgärden som ska utföras på Azure-resurser eller resursgruppen.

actionClassic - åtgärd
string. Krävs när ConnectedServiceNameSelector = ConnectedServiceNameClassic. Tillåtna värden: Select Resource Group (Välj molntjänst). Standardvärde: Select Resource Group.

Åtgärden som ska utföras på Azure-resurser eller molntjänsten.

resourceGroupName - resursgrupp
string. Krävs när ConnectedServiceNameSelector = ConnectedServiceName.

Anger namnet på resursgruppen.

cloudService - Cloud Service
string. Krävs när ConnectedServiceNameSelector = ConnectedServiceNameClassic.

Anger namnet på molntjänsten.

location - plats
string. Krävs när action = Create Or Update Resource Group. Tillåtna värden: Australia East, Australia Southeast, Brazil South, Canada Central, Canada East, Central India, Central US, East Asia, East US, East US 2 , Japan East, Japan West, North Central US, North Europe, South Central US, South India, Southeast Asia, UK South, UK West, West Central US, West Europe, West India, West US, West US 2. Standardvärde: East US.

Platsen där resursgruppen ska distribueras. Om resursgruppen redan finns i prenumerationen ignoreras det här värdet.

csmFile - Mall
string. Krävs när action = Create Or Update Resource Group.

Anger sökvägen eller ett mönster som pekar på Azure Resource Manager-mallen. Läs mer om Azure Resource Manager-mallar. Kom igång direkt genom att använda den här exempelmallen.

csmParametersFile - mallparametrar
string. Valfritt. Använd när action = Create Or Update Resource Group.

Anger URL:en för parameterfilen. En exempel-URL: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

Om du vill använda en fil som lagras i ett privat lagringskonto hämtar och inkluderar du SAS-token (signatur för delad åtkomst) i URL:en för mallen. Exempel: <blob_storage_url>/template.json?<SAStoken> Om du vill ladda upp en parameterfil till ett lagringskonto och generera en SAS-token använder du Azure-filkopiering uppgift eller följer stegen med hjälp av PowerShell- eller Azure CLI-.

Om du vill visa mallparametrarna i ett rutnät klickar du på … bredvid textrutan åsidosätt mallparametrar. Den här funktionen kräver att CORS-regler är aktiverade vid källan. Om mallar finns i Azure Storage Blob kan du läsa resursdelning mellan ursprung för att aktivera CORS.

overrideParameters - åsidosätt mallparametrar
string. Valfritt. Använd när action = Create Or Update Resource Group.

Anger de mallparametrar som ska åsidosättas.

Om du vill visa mallparametrarna i ett rutnät klickar du på ... bredvid textrutan Åsidosättningsparametrar. Den här funktionen kräver att CORS-regler är aktiverade vid källan. Om mallarna finns i Azure Storage-bloben refererar du till den här strängen för att aktivera CORS eller skriver de mallparametrar som ska åsidosättas i textrutan.

Exempel: -storageName fabrikam -adminUsername $(vmusername) -adminPassword (ConvertTo-SecureString -String '$(password)' -AsPlainText -Force) -azureKeyVaultName $(fabrikamFibre).

Om parametervärdet har flera ord omger du orden med citattecken, även om du skickar värdet med hjälp av variabler. Till exempel -name "parameter value" -name2 "$(var)". Om du vill åsidosätta objekttypsparametrar använder du strängifierade JSON-objekt. Till exempel -options ["option1"] -map {"key1": "value1" }.

deploymentMode - distributionsläge
string. Krävs när action = Create Or Update Resource Group. Tillåtna värden: Validation (endast validering), Incremental, Complete. Standardvärde: Incremental.

I Incremental-läget hanteras distributioner som inkrementella uppdateringar av resursgruppen. Den lämnar oförändrade resurser som finns i resursgruppen men som inte anges i mallen.

Complete läge tar bort resurser som inte finns i mallen. Slutfört läge tar relativt mer tid än inkrementellt läge. Om aktiviteten överskrider tidsgränsen kan du överväga att öka tidsgränsen eller ändra till Incremental läge.

Varning

Fullständigt läge tar bort alla befintliga resurser i resursgruppen som inte har angetts i mallen. Granska om resursgruppen som du distribuerar till inte innehåller några nödvändiga resurser som inte anges i mallen.

Validate läge kan du hitta problem med mallen innan du skapar faktiska resurser.

Anmärkning

Validate-läget skapar alltid en resursgrupp, även om inga resurser distribueras.

Läs mer om distributionslägen.

enableDeploymentPrerequisitesForCreate - Aktivera krav för distribution
boolean. Valfritt. Använd när action = Create Or Update Resource Group. Standardvärde: false.

Gäller endast när resursgruppen innehåller virtuella datorer.

Om du väljer alternativet Distributionsgrupp konfigureras distributionsgruppsagenten på var och en av de virtuella datorerna.

Om du väljer WinRM-alternativet konfigureras WinRM-lyssnaren (Windows Remote Management) via HTTPS-protokollet på port 5986 med hjälp av ett självsignerat certifikat. Den här konfigurationen krävs för att utföra distributionsåtgärden på Azure-datorer. Om de virtuella måldatorerna backas upp av en lastbalanserare kontrollerar du att de inkommande NAT-reglerna har konfigurerats för målporten (5986).

enableDeploymentPrerequisitesForSelect - Aktivera krav för distribution
boolean. Valfritt. Använd när action = Select Resource Group. Standardvärde: false.

Gäller endast när resursgruppen innehåller virtuella datorer.

Om du väljer alternativet Distributionsgrupp konfigureras distributionsgruppsagenten på var och en av de virtuella datorerna.

outputVariable - resursgrupp
string.

Krävs när en befintlig resursgrupp har valts. Innehåller ett namn på resursgruppsvariabeln. Variabeln kan användas som $(variableName) för att referera till resursgruppen i efterföljande aktiviteter, till exempel i PowerShell på måldatorer för distribution av program.

Gäller endast när den valda åtgärden är Create, Updateeller Select.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Lokalt installerade agenter måste ha funktioner som matchar följande kräver att köra jobb som använder den här uppgiften: azureps
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	1.103.0 eller senare
Aktivitetskategori	Gruppera

Dela via