AzureCloudPowerShellDeployment@1 – Azure Cloud Service-Bereitstellung v1-Aufgabe

Artikel
03/24/2025

Stellen Sie einen Azure Cloud Service bereit.

Hinweis

Diese Aufgabe unterstützt keine Azure Resource Manager-Authentifizierung mit Workflowidentitätsverbund.

Diese Aufgabe ist veraltet, da Azure Cloud Services eingestellt wird, siehe Migrieren von Azure Cloud Services (klassisch) zu Azure Cloud Services (erweiterter Support).

Stellen Sie einen Azure Cloud Service bereit.

Hinweis

Diese Aufgabe unterstützt keine Azure Resource Manager-Authentifizierung mit Workflowidentitätsverbund.

Syntax

# Azure Cloud Service deployment v1
# Deploy an Azure Cloud Service.
- task: AzureCloudPowerShellDeployment@1
  inputs:
    azureClassicSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription (Classic). 
    #EnableAdvancedStorageOptions: false # boolean. Enable ARM storage support. Default: false.
    StorageAccount: # string. Required when EnableAdvancedStorageOptions = false. Storage account (Classic). 
    #ARMConnectedServiceName: # string. Required when EnableAdvancedStorageOptions = true. Azure subscription (ARM). 
    #ARMStorageAccount: # string. Required when EnableAdvancedStorageOptions = true. Storage account (ARM). 
    ServiceName: # string. Required. Service name. 
    ServiceLocation: # string. Required. Service location. 
    CsPkg: # string. Required. CsPkg. 
    CsCfg: # string. Required. CsCfg. 
    slotName: 'Production' # string. Alias: Slot. Required. Environment (Slot). Default: Production.
    #DeploymentLabel: '$(Build.BuildNumber)' # string. Deployment label. Default: $(Build.BuildNumber).
    #AppendDateTimeToLabel: false # boolean. Append current date and time. Default: false.
    #AllowUpgrade: true # boolean. Allow upgrade. Default: true.
    #SimultaneousUpgrade: false # boolean. Optional. Use when AllowUpgrade == true. Simultaneous upgrade. Default: false.
    #ForceUpgrade: false # boolean. Optional. Use when AllowUpgrade == true. Force upgrade. Default: false.
    #VerifyRoleInstanceStatus: false # boolean. Verify role instance status. Default: false.
  # Advanced Options For Creating New Service
    #DiagnosticStorageAccountKeys: # string. Diagnostic storage account keys. 
    #NewServiceCustomCertificates: # string. Custom certificates to import. 
    #NewServiceAdditionalArguments: # string. Additional arguments. 
    #NewServiceAffinityGroup: # string. Affinity group.

Eingänge

azureClassicSubscription - Azure-Abonnement (klassisch)
Eingabealias: ConnectedServiceName. string. Erforderlich.

Das Azure-Abonnement für die Bereitstellung.

EnableAdvancedStorageOptions - Aktivieren der ARM-Speicherunterstützung
boolean. Standardwert: false.

Aktiviert oder deaktiviert die ARM-Speicherunterstützung.

StorageAccount - Speicherkonto (klassisch)
string. Erforderlich, wenn EnableAdvancedStorageOptions = false.

Das Speicherkonto muss vor der Bereitstellung vorhanden sein.

ARMConnectedServiceName - Azure-Abonnement (ARM)
string. Erforderlich, wenn EnableAdvancedStorageOptions = true.

Das ARM-Abonnement.

ARMStorageAccount - Speicherkonto (ARM)
string. Erforderlich, wenn EnableAdvancedStorageOptions = true.

Ein bereits vorhandenes ARM-Speicherkonto.

ServiceName - Dienstname
string. Erforderlich.

Ein vorhandener Clouddienstname.

ServiceLocation - Dienststandort
string. Erforderlich.

Eine Region für die neue Dienstbereitstellung. Zu den Optionen gehören: Ost-USA, Ost-USA 2, Zentral-USA, Süd-Zentral-USA, West-USA, Nordeuropa, Westeuropa und andere.

CsPkg - CsPkg-
string. Erforderlich.

Pfad zum CsPkg im Standardartefaktverzeichnis.

CsCfg - CsCfg-
string. Erforderlich.

Der CsCfg-Pfad im Standardartefaktverzeichnis.

slotName - Umgebung (Slot)
Eingabealias: Slot. string. Erforderlich. Standardwert: Production.

Legen Sie diesen Wert auf "Staging" fest, oder verwenden Sie den Standardwert.

DeploymentLabel - Bereitstellungsbezeichnung
string. Standardwert: $(Build.BuildNumber).

Gibt den Bezeichnungsnamen für die neue Bereitstellung an. Wenn nicht angegeben, wird standardmäßig eine GUID (Globally Unique Identifier) verwendet.

AppendDateTimeToLabel - Aktuelle Datums- und Uhrzeit- anfügen
boolean. Standardwert: false.

Fügt das aktuelle Datum und die aktuelle Uhrzeit an die Bereitstellungsbezeichnung an.

AllowUpgrade - Upgrade- zulassen
boolean. Standardwert: true.

Ermöglicht ein Upgrade auf die Microsoft Azure-Bereitstellung.

SimultaneousUpgrade - gleichzeitiges Upgrade
boolean. Wahlfrei. Wird verwendet, wenn AllowUpgrade == true. Standardwert: false.

Aktualisiert alle Instanzen gleichzeitig. Ihr Clouddienst ist während dieses Zeitraums nicht verfügbar.

ForceUpgrade - erzwingen
boolean. Wahlfrei. Wird verwendet, wenn AllowUpgrade == true. Standardwert: false.

Legt ein erzwungenes Upgrade fest. Das Erzwingen eines Upgrades kann zu Einem Verlust lokaler Daten führen.

VerifyRoleInstanceStatus - Überprüfen des Rolleninstanzstatus
boolean. Standardwert: false.

Bewirkt, dass die Aufgabe wartet, bis Rolleninstanzen im Status "Bereit" sind.

DiagnosticStorageAccountKeys - Diagnosespeicherkontoschlüssel
string.

Formatieren Sie die Speicherschlüsselzeichenfolge als Role:Storagekey. Der Name des Diagnosespeicherkontos für jede Rolle wird aus der Diagnosekonfigurationsdatei (WADCFGX) abgerufen.

Wenn die WADCFGX-Datei für eine Rolle nicht gefunden wird: Die Diagnoseerweiterung ist für diese Rolle nicht festgelegt.
Wenn der Name des Speicherkontos in der WADCFGX-Datei nicht gefunden wird: Das Standardspeicherkonto wird zum Speichern von Diagnoseergebnissen verwendet, und Speicherschlüsselparameter aus der Bereitstellungsaufgabe werden ignoriert.

HINWEIS: Wenn in den Diagnoseergebnissen für Ihre Umgebung vertrauliche Informationen vorhanden sind, speichern Sie die storage_account_key als geheime Variable. Beispiel:

WebRole: WebRole_storage_account_key
WorkerRole: WorkerRole_stoarge_account_key

NewServiceCustomCertificates - Benutzerdefinierte Zertifikate zum Importieren von
string.

Formatieren Sie die benutzerdefinierte Zertifikatzeichenfolge als CertificatePfxBase64:CertificatePassword. Speichern Sie die certificate_password als geheime Variable. Beispiel:

Zertifikat1: Certificate1_password
Zertifikat2: Certificate2_password

NewServiceAdditionalArguments - Zusätzliche Argumente
string.

Übergibt beim Erstellen eines neuen Diensts zusätzliche Argumente. Argumente werden an das Cmdlet New-AzureService übergeben. Beispiel: -Label 'MyTestService'.

NewServiceAffinityGroup - Affinitätsgruppe
string.

Die Beim Erstellen eines neuen Diensts verwendete Affinitätsgruppe anstelle des Dienststandorts.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Verwenden Sie diese Aufgabe, um einen Azure Cloud Service bereitzustellen.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent
Anforderungen	Self-hosted agents must have capabilities that match the following anforderungen to run jobs that use this task: azureps:
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	1.103.0 oder höher
Vorgangskategorie	Einsetzen

Freigeben über