Freigeben über


AzureFileCopy@1 – Aufgabe zum Kopieren von Azure-Dateien v1

Kopieren Sie Dateien in Azure Blob Storage oder virtuelle Computer.

Diese Aufgabe ist veraltet, da diese Version der Aufgabe AzureFileCopy eine abgelöste Version von AzCopy verwendet. Verwenden Sie die neueste Version der AzureFileCopy-Aufgabe. Weitere Informationen finden Sie unter AzCopy-Migrationshandbuch für v8 auf v10.

Kopieren Sie Dateien in Azure Blob Storage oder virtuelle Computer.

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.

Eingänge

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 (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Standardwert: ConnectedServiceNameARM.

Geben Sie den Azure-Verbindungstyp an.


azureClassicSubscription - azure Classic-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 in Azure-VMs verwendet wird.


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

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


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

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

Um ein virtuelles Verzeichnis innerhalb des Containers zu erstellen, verwenden Sie die Blob-Präfixeingabe.

Beispiel: Geben Sie als Zielspeicherort https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/den Containernamen mycontainer und das Blob-Präfix an: vd1/vd2.


BlobPrefix - Blobpräfix-
string. Wahlfrei. Wird verwendet, 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 Blob-Präfix myvd1angeben, wird ein virtuelles Verzeichnis innerhalb des Containers 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 Ziel-Cloud-Diensts an.


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

Geben Sie den Namen der Zielressourcengruppe an.


ResourceFilteringMethod - Computer nach auswählen
string. Wahlfrei. Wird verwendet, wenn Destination = AzureVMs. Zulässige Werte: machineNames (Computernamen), tags. Standardwert: machineNames.

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


MachineNames - Filterkriterien
string. Wahlfrei. Wird verwendet, wenn Destination = AzureVMs.

Geben Sie eine Liste von Hostnamen für Azure-VMs an, ffdbz. B. , ffweb, oder Tags wie Role:DB, WebOS:Win8.1, .

Hinweis: Gültige Trennzeichen für Tags sind ,(Komma), :(Doppelpunkt) und ;(Semikolon). Wenn Sie mehrere Tags bereitstellen, wird die Aufgabe nur auf den VMs ausgeführt, die die angegebenen Tags enthalten. Standardmäßig wird die Aufgabe auf allen virtuellen Computern ausgeführt.


vmsAdminUserName - Administratoranmeldung
string. Erforderlich, wenn Destination = AzureVMs.

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


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

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

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


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

Geben Sie den lokalen Pfad auf den Ziel-VMs an, um Dateien aus der Quelle zu kopieren.

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


AdditionalArguments - Zusätzliche Argumente
string.

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


enableCopyPrerequisites - Aktivieren von Kopiervoraussetzungen
boolean. Wahlfrei. Wird verwendet, wenn ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Standardwert: false.

Wenn diese Option aktiviert ist, wird ein selbstsigniertes Zertifikat verwendet, um einen WinRM-Listener (Windows Remote Management) an Port 5986 anstelle des HTTPS-Protokolls zu konfigurieren. Erforderlich für das 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 - Kopieren in paralleler
boolean. Wahlfrei. Wird verwendet, wenn Destination = AzureVMs. Standardwert: true.

Wenn Sie die Standardeinstellung übernehmen, werden Dateien parallel zu den Ziel-VMs kopiert.


CleanTargetBeforeCopy - clean Target
boolean. Wahlfrei. Wird verwendet, wenn Destination = AzureVMs. Standardwert: false.

Die Einstellung löscht true den Zielordner, bevor der Kopiervorgang ausgeführt wird.


skipCACheck - Testzertifikat
boolean. Wahlfrei. Wird verwendet, wenn Destination = AzureVMs. Standardwert: true.

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


outputStorageUri - URI des Lagerbehälters
string.

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


Aufgabensteuerungsoptionen

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

Ausgabevariablen

Keiner.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Classic Build, Classic Release
Läuft auf Agent, DeploymentGroup
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 Beliebig
Settable-Variablen Beliebig
Agentversion 1.103.0 oder höher
Vorgangskategorie Einsetzen