AzureFileCopy@1: Azure-Dateikopiervorgang v1

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 v1
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@1
  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. 
    #AdditionalArguments: # string. Additional Arguments. 
    #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 des Quellordners, der Datei auf dem lokalen Computer oder 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.

Beispiel: Geben Sie 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 einen VM-Hostnamen oder ein Tag an, der 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 die Aufgabe nur auf den virtuellen Computern ausgeführt, die die angegebenen Tags enthalten. Standardmäßig wird der Task auf allen virtuellen Computern 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 zum Kopieren von Dateien aus der Quelle an.

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

AdditionalArguments - Zusätzliche Argumente
string.

Stellen Sie zusätzliche Argumente bereit, die AzCopy.exe beim Hochladen auf Blobs oder VMs angewendet werden, /NC:10z. B. .

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 zu den Ziel-VMs kopiert.

CleanTargetBeforeCopy - Ziel bereinigen
boolean. Optional. Verwenden Sie , wenn Destination = AzureVMs. Standardwert. false.

Durch festlegen, dass der true Zielordner vor dem Ausführen der Kopieraktion bereinigt wird.

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

Der Standardwert überprüft nicht, ob das Serverzertifikat vor der Verbindung über HTTPS von einer vertrauenswürdigen Zertifizierungsstelle signiert wurde.

outputStorageUri - Speichercontainer-URI
string.

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

outputStorageContainerSasToken - SAS-Token für Speichercontainer
string.

Geben Sie den Namen der Variablen an, die für das SAS-Token des Speichercontainers verwendet wird, das auf die kopierten Dateien zugreift. Gültig nur, 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.

Anforderungen

Anforderung	Beschreibung
Pipelinetypen	YAML, Klassischer Build, klassische Version
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
Einstellbare Variablen	Any
Agent-Version	1.103.0 oder höher
Aufgabenkategorie	Bereitstellen