AzureFileCopy@2: Azure-Dateikopiervorgang v2

Kopieren von Dateien auf Azure Blob Storage oder virtuelle Computer.

Hinweis

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

Syntax

# Azure file copy v2
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    #classicStorage: # string. Alias: StorageAccount. Required when ConnectedServiceNameSelector = ConnectedServiceName. Classic Storage Account. 
    storage: # string. Alias: StorageAccountRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #cloudService: # string. Alias: EnvironmentName. Required when ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs. Cloud Service. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Resource Group. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Optional. Use when Destination = AzureVMs. Select Machines By. Default: machineNames.
    #MachineNames: # string. Optional. Use when Destination = AzureVMs. Filter Criteria. 
    #vmsAdminUserName: # string. Required when Destination = AzureVMs. Admin Login. 
    #vmsAdminPassword: # string. Required when Destination = AzureVMs. Password. 
    #TargetPath: # string. Required when Destination = AzureVMs. Destination Folder. 
    #AdditionalArgumentsForBlobCopy: # string. Optional Arguments (for uploading files to blob). 
    #AdditionalArgumentsForVMCopy: # string. Optional. Use when Destination = AzureVMs. Optional Arguments (for downloading files to VM). 
    #enableCopyPrerequisites: false # boolean. Optional. Use when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
    #CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
    #CleanTargetBeforeCopy: false # boolean. Optional. Use when Destination = AzureVMs. Clean Target. Default: false.
    #skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.
  # Output
    #outputStorageUri: # string. Storage Container URI. 
    #outputStorageContainerSasToken: # string. Storage Container SAS Token.

Eingaben

SourcePath - Quelle
string. Erforderlich.

Geben Sie den absoluten Pfad zum Quellordner, zur Datei auf dem lokalen Computer oder zu einer UNC-Freigabe an. Der angegebene Wert oder Ausdruck sollte entweder einen einzelnen Ordnernamen oder einen Dateinamen zurückgeben.

azureConnectionType - Azure-Verbindungstyp
Eingabealias: ConnectedServiceNameSelector. string. Zulässige Werte: ConnectedServiceName (klassische Azure), ConnectedServiceNameARM (Azure Resource Manager). Standardwert. ConnectedServiceNameARM.

Geben Sie den Azure-Verbindungstyp an.

azureClassicSubscription - Klassisches Azure-Abonnement
Eingabealias: ConnectedServiceName. string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceName.

Geben Sie das klassische Azure-Zielabonnement an.

azureSubscription - Azure-Abonnement
Eingabealias: ConnectedServiceNameARM. string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceNameARM.

Geben Sie das Azure Resource Manager-Zielabonnement an.

Destination - Zieltyp
string. Erforderlich. Zulässige Werte: AzureBlob (Azure Blob), AzureVMs (Azure-VMs).

Geben Sie den Zieltyp an, der zum Kopieren der Dateien verwendet werden soll.

classicStorage - Klassisches Speicherkonto
Eingabealias: StorageAccount. string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceName.

Geben Sie ein bereits vorhandenes klassisches Speicherkonto an. Dies ist das Speicherkonto, das als Vermittler zum Kopieren von Dateien auf Azure-VMs verwendet wird.

storage - RM-Speicherkonto
Eingabealias: StorageAccountRM. string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceNameARM.

Wählen Sie ein bereits vorhandenes ARM-Speicherkonto aus. Dies ist das Speicherkonto, das als Vermittler zum Kopieren von Dateien auf Azure-VMs verwendet wird.

ContainerName - Containername
string. Erforderlich, wenn Destination = AzureBlob.

Geben Sie den Namen des Containers an, in den Dateien kopiert werden. Wenn der angegebene Container nicht im Speicherkonto vorhanden ist, wird er erstellt.

Verwenden Sie die Blobpräfixeingabe, um ein virtuelles Verzeichnis innerhalb des Containers zu erstellen. Geben Sie beispielsweise für den Zielspeicherort https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/den Containernamen mycontainer und das Blobpräfix an vd1/vd2.

BlobPrefix - Blobpräfix
string. Optional. Verwenden Sie , wenn Destination = AzureBlob.

Geben Sie ein Präfix an, das zum Filtern von Dateien verwendet werden kann.

Beispiel: Sie können eine Buildnummer anfügen, um die Dateien aus allen Blobs mit derselben Buildnummer zu filtern.

Beispiel: Wenn Sie ein Blobpräfix myvd1angeben, wird im Container ein virtuelles Verzeichnis erstellt. Dateien werden aus der Quelle in https://myaccount.blob.core.windows.net/mycontainer/myvd1/kopiert.

cloudService - Clouddienst
Eingabealias: EnvironmentName. string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Geben Sie den Namen des Zielclouddiensts an.

resourceGroup - Ressourcengruppe
Eingabealias: EnvironmentNameRM. string. Erforderlich, wenn ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

Geben Sie den Namen der Zielressourcengruppe an.

ResourceFilteringMethod - Wählen Sie Computer nach aus.
string. Optional. Verwenden Sie , wenn Destination = AzureVMs. Zulässige Werte: machineNames (Computernamen), tags. Standardwert. machineNames.

Geben Sie den Vm-Hostnamen oder das Tag an, das eine Teilmenge von VMs in einer Ressourcengruppe identifiziert. Tags werden nur für Ressourcen unterstützt, die über die Azure-Resource Manager erstellt wurden.

MachineNames - Filterkriterien
string. Optional. Verwenden Sie , wenn Destination = AzureVMs.

Geben Sie eine Liste von Azure-VM-Hostnamen an, z ffweb. B. , ffdboder Tags wie Role:DB, Web, OS:Win8.1.

Hinweis: Gültige Trennzeichen für Tags sind , (Komma), :(kolon) und ;(semicolon). Wenn mehrere Tags bereitgestellt werden, wird der Task auf allen virtuellen Computern ausgeführt, die die angegebenen Tags enthalten. Standardmäßig wird der Task auf allen VMs ausgeführt.

vmsAdminUserName - Admin Anmeldung
string. Erforderlich, wenn Destination = AzureVMs.

Geben Sie den Benutzernamen des Azure-VM-Administratorkontos an.

vmsAdminPassword - Passwort
string. Erforderlich, wenn Destination = AzureVMs.

Geben Sie das Kennwort für das Azure-VM-Administratorkonto an.

Gültige Eingaben umfassen Variablen, die in Build- oder Releasepipelines wie $(passwordVariable)definiert sind. Um ein Kennwort zu schützen, markieren Sie es als secret.

TargetPath - Zielordner
string. Erforderlich, wenn Destination = AzureVMs.

Geben Sie den lokalen Pfad auf den Ziel-VMs an.

Gültige Eingaben umfassen Umgebungsvariablen wie $env:windir\BudgetIT\Web.

AdditionalArgumentsForBlobCopy - Optionale Argumente (zum Hochladen von Dateien in ein Blob)
string.

Stellen Sie zusätzliche Argumente bereit, die AzCopy.exe beim Hochladen in Blobs angewendet werden können, z /NC:10. B. .

Wenn keine optionalen Argumente angegeben werden, werden standardmäßig die folgenden Argumente hinzugefügt.

• /Y
• /SetContentType
• /Z
• /V
• /S – Hinzugefügt, wenn der Containername nicht $rootist.
• /BlobType:page – Wird hinzugefügt, wenn das angegebene Speicherkonto ein Premium-Konto ist.
• /Pattern – Wird hinzugefügt, wenn der Quellpfad eine Datei ist. In allen anderen angegebenen optionalen Argumenten enthalten.

AdditionalArgumentsForVMCopy - Optionale Argumente (zum Herunterladen von Dateien auf den virtuellen Computer)
string. Optional. Verwenden Sie , wenn Destination = AzureVMs.

Stellen Sie zusätzliche Argumente bereit, die AzCopy.exe beim Herunterladen auf VMs angewendet werden können, z /NC:10. B. .

Wenn keine optionalen Argumente angegeben werden, werden standardmäßig Folgende hinzugefügt.

• /Y
• /S
• /Z
• /V

enableCopyPrerequisites - Aktivieren der Kopiervoraussetzungen
boolean. Optional. Verwenden Sie , wenn ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Standardwert. false.

Wenn diese Option aktiviert ist, wird ein selbstsigniertes Zertifikat verwendet, um einen Windows-Remoteverwaltungslistener (WinRM) an Port 5986 anstelle des HTTPS-Protokolls zu konfigurieren. Erforderlich zum Ausführen von Kopiervorgängen auf Azure-VMs. Wenn die Ziel-VMs einen Lastenausgleich verwenden, konfigurieren Sie NAT-Regeln für eingehenden Datenverkehr für den Zielport (5986). Gilt nur für ARM-VMs.

CopyFilesInParallel - Parallel kopieren
boolean. Optional. Verwenden Sie , wenn Destination = AzureVMs. Standardwert. true.

Wenn Sie die Standardeinstellung akzeptieren, werden Dateien parallel auf die Ziel-VMs kopiert.

CleanTargetBeforeCopy - Bereinigen des Ziels
boolean. Optional. Verwenden Sie , wenn Destination = AzureVMs. Standardwert. false.

Wenn Sie diesen Wert auf festlegen, wird true der Zielordner vor dem Ausführen der Kopieraktion bereinigt.

skipCACheck - Testzertifikat
boolean. Optional. Verwenden Sie , wenn Destination = AzureVMs. Standardwert. true.

Der Standardwert überprüft nicht, ob das Serverzertifikat von einer vertrauenswürdigen Zertifizierungsstelle signiert wurde, bevor eine Verbindung über HTTPS hergestellt wird.

outputStorageUri - Speichercontainer-URI
string.

Geben Sie den Namen der Variablen an, die für den Speichercontainer-URI verwendet wird, in den Dateien kopiert wurden. Nur gültig, wenn das ausgewählte Ziel ein Azure-Blob ist.

outputStorageContainerSasToken - Speichercontainer-SAS-Token
string.

Geben Sie den Namen der Variablen an, die für das SAS-Token des Speichercontainers verwendet wird, das auf die kopierten Dateien zugreift. Nur gültig, wenn das ausgewählte Ziel ein Azure-Blob ist.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Neuerungen in Version 2.0: Verwenden einer neueren Version von AzCopy.

Anforderungen

Anforderung	Beschreibung
Pipelinetypen	YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: azureps
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	1.103.0 oder höher
Aufgabenkategorie	Bereitstellen