Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Hinweis
Diese Aufgabe unterstützt keine Azure Resource Manager-Authentifizierung mit Workflowidentitätsverbund.
Kopieren Sie Dateien in Azure Blob Storage oder virtuelle Computer.
Hinweis
Diese Aufgabe unterstützt keine Azure Resource Manager-Authentifizierung mit 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.
Eingänge
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 (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 Eingabe des Blobpräfixes. Geben Sie z. B. als Zielspeicherort https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/den Containernamen mycontainer und das Blob-Präfix vd1/vd2an.
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 den Namen oder das Tag des VM-Hosts an, mit dem eine Teilmenge der VMs in einer Ressourcengruppe identifiziert wird. 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 auf allen VMs ausgeführt, die die angegebenen Tags enthalten. Standardmäßig wird die Aufgabe auf allen VMs 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.
Gültige Eingaben sind Umgebungsvariablen wie $env:windir\BudgetIT\Web.
AdditionalArgumentsForBlobCopy
-
optionale Argumente (zum Hochladen von Dateien in blob)
string.
Geben Sie zusätzliche Argumente an AzCopy.exe , die beim Hochladen in Blobs angewendet werden können, z. B /NC:10. .
Wenn keine optionalen Argumente angegeben werden, werden standardmäßig die folgenden Argumente hinzugefügt.
/Y/SetContentType/Z/V-
/S- Wird hinzugefügt, wenn der Containername nicht$root. -
/BlobType:page- Wird hinzugefügt, wenn es sich bei dem angegebenen Speicherkonto um ein Premium-Konto handelt. -
/Pattern- Wird hinzugefügt, wenn der Quellpfad eine Datei ist. Ist in allen anderen angegebenen optionalen Argumenten enthalten.
AdditionalArgumentsForVMCopy
-
optionale Argumente (zum Herunterladen von Dateien auf einen virtuellen Computer)
string. Wahlfrei. Wird verwendet, wenn Destination = AzureVMs.
Geben Sie zusätzliche Argumente an AzCopy.exe , die beim Herunterladen auf VMs angewendet werden können, z. B /NC:10. .
Wenn keine optionalen Argumente angegeben sind, werden standardmäßig die folgenden Argumente hinzugefügt.
/Y/S/Z/V
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.
Wenn Sie diesen Wert festlegen, wird true der Zielordner bereinigt, bevor der Kopiervorgang ausgeführt wird.
skipCACheck
-
Testzertifikat
boolean. Wahlfrei. Wird verwendet, wenn Destination = AzureVMs. Standardwert: true.
Mit dem Standardwert wird nicht überprüft, ob 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.
Bemerkungen
Neue Funktionen in Version 2.0: Verwenden einer neueren Version von AzCopy.
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 |