Delen via


AzureFileCopy@2 - Azure-bestandskopie v2-taak

Kopieer bestanden naar Azure Blob Storage of virtuele machines.

Deze taak is afgeschaft omdat deze versie van de AzureFileCopy-taak gebruikmaakt van een buiten gebruik gestelde versie van AzCopy. Gebruik de nieuwste versie van de AzureFileCopy-taak. Zie AzCopy-migratiehandleiding voor v8 naar v10.

Notitie

Deze taak biedt geen ondersteuning voor Azure Resource Manager-verificatie metvoor werkstroomidentiteitsfederatie.

Kopieer bestanden naar Azure Blob Storage of virtuele machines.

Notitie

Deze taak biedt geen ondersteuning voor Azure Resource Manager-verificatie metvoor werkstroomidentiteitsfederatie.

Syntaxis

# 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.

Invoer

SourcePath - bron
string. Verplicht.

Geef het absolute pad op naar de bronmap, het bestand op de lokale computer of een UNC-share. De opgegeven waarde of expressie moet ofwel één mapnaam of bestandsnaam retourneren.


azureConnectionType - Azure-verbindingstype
Invoeralias: ConnectedServiceNameSelector. string. Toegestane waarden: ConnectedServiceName (klassiek Azure), ConnectedServiceNameARM (Azure Resource Manager). Standaardwaarde: ConnectedServiceNameARM.

Geef het Azure-verbindingstype op.


azureClassicSubscription - klassieke Azure-abonnement
Invoeralias: ConnectedServiceName. string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceName.

Geef het klassieke Azure-doelabonnement op.


azureSubscription - Azure-abonnement
Invoeralias: ConnectedServiceNameARM. string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceNameARM.

Geef het Azure Resource Manager-doelabonnement op.


Destination - doeltype
string. Verplicht. Toegestane waarden: AzureBlob (Azure Blob), AzureVMs (Azure-VM's).

Geef het doeltype op dat moet worden gebruikt voor het kopiëren van de bestanden.


classicStorage - klassiek opslagaccount
Invoeralias: StorageAccount. string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceName.

Geef een bestaand klassiek opslagaccount op. Dit is het opslagaccount dat wordt gebruikt als intermediair voor het kopiëren van bestanden naar Azure-VM's.


storage - RM-opslagaccount
Invoeralias: StorageAccountRM. string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceNameARM.

Geef een bestaand ARM-opslagaccount op. Dit is het opslagaccount dat wordt gebruikt als intermediair voor het kopiëren van bestanden naar Azure-VM's.


ContainerName - containernaam
string. Vereist wanneer Destination = AzureBlob.

Geef de naam op van de container waarin bestanden worden gekopieerd. Als de opgegeven container niet bestaat in het opslagaccount, wordt deze gemaakt.

Als u een virtuele map in de container wilt maken, gebruikt u de invoer van het blobvoorvoegsel. Geef bijvoorbeeld voor de doellocatie https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/de containernaam mycontainer en het blobvoorvoegsel vd1/vd2op.


BlobPrefix - blobvoorvoegsel
string. Facultatief. Gebruiken wanneer Destination = AzureBlob.

Geef een voorvoegsel op dat kan worden gebruikt om bestanden te filteren.

Voorbeeld: U kunt een buildnummer toevoegen om de bestanden van alle blobs met hetzelfde buildnummer te filteren.

Voorbeeld: Als u een blobvoorvoegsel opgeeft myvd1, wordt er een virtuele map in de container gemaakt. Bestanden worden gekopieerd van de bron naar https://myaccount.blob.core.windows.net/mycontainer/myvd1/.


cloudService - cloudservice
Invoeralias: EnvironmentName. string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Geef de naam van de doelcloudservice op.


resourceGroup - resourcegroep
Invoeralias: EnvironmentNameRM. string. Vereist wanneer ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

Geef de naam van de doelresourcegroep op.


ResourceFilteringMethod - Machines selecteren op
string. Facultatief. Gebruiken wanneer Destination = AzureVMs. Toegestane waarden: machineNames (machinenamen), tags. Standaardwaarde: machineNames.

Geef de hostnaam of tag van de VM op waarmee een subset van vm's in een resourcegroep wordt geïdentificeerd. Tags worden alleen ondersteund voor resources die zijn gemaakt via Azure Resource Manager.


MachineNames - filtercriteria
string. Facultatief. Gebruiken wanneer Destination = AzureVMs.

Geef een lijst op met hostnamen van Azure-VM's, zoals ffweb, ffdbof tags zoals Role:DB, Web, OS:Win8.1.

Opmerking: Geldige scheidingstekens voor tags zijn onder andere (komma), :(komma) en ;(semicolon). Wanneer u meerdere tags opgeeft, wordt de taak uitgevoerd op alle VM's die de opgegeven tags bevatten. De taak wordt standaard uitgevoerd op alle VM's.


vmsAdminUserName - aanmeldgegevens van beheerders
string. Vereist wanneer Destination = AzureVMs.

Geef de gebruikersnaam van het Beheerdersaccount van de Azure-VM op.


vmsAdminPassword - wachtwoord
string. Vereist wanneer Destination = AzureVMs.

Geef het wachtwoord op voor het Azure VM-beheerdersaccount.

Geldige invoer bevat variabelen die zijn gedefinieerd in build- of release-pijplijnen, zoals $(passwordVariable). Als u een wachtwoord wilt beveiligen, markeert u het als secret.


TargetPath - doelmap
string. Vereist wanneer Destination = AzureVMs.

Geef het lokale pad op de doel-VM's op.

Geldige invoer bevat omgevingsvariabelen zoals $env:windir\BudgetIT\Web.


AdditionalArgumentsForBlobCopy - Optionele argumenten (voor het uploaden van bestanden naar blob)
string.

Geef aanvullende argumenten op voor AzCopy.exe die kunnen worden toegepast bij het uploaden naar blobs, zoals /NC:10.

Als er geen optionele argumenten zijn opgegeven, worden de volgende argumenten standaard toegevoegd.

  • /Y
  • /SetContentType
  • /Z
  • /V
  • /S - Toegevoegd wanneer de containernaam niet is $root.
  • /BlobType:page - Toegevoegd wanneer het opgegeven opslagaccount een Premium-account is.
  • /Pattern - Toegevoegd wanneer het bronpad een bestand is. Opgenomen in andere opgegeven optionele argumenten.

AdditionalArgumentsForVMCopy - optionele argumenten (voor het downloaden van bestanden naar VM)
string. Facultatief. Gebruiken wanneer Destination = AzureVMs.

Geef aanvullende argumenten op voor AzCopy.exe die kunnen worden toegepast bij het downloaden naar VM's, zoals /NC:10.

Als er geen optionele argumenten zijn opgegeven, worden de volgende standaard toegevoegd.

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

enableCopyPrerequisites - vereisten voor kopiëren inschakelen
boolean. Facultatief. Gebruiken wanneer ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Standaardwaarde: false.

Als dit is ingeschakeld, gebruikt u een zelfondertekend certificaat om een WinRM-listener (Windows Remote Management) te configureren op poort 5986 in plaats van het HTTPS-protocol. Vereist voor het uitvoeren van kopieerbewerkingen op Azure-VM's. Als de doel-VM's een load balancer gebruiken, configureert u binnenkomende NAT-regels voor de doelpoort (5986). Is alleen van toepassing op ARM-VM's.


CopyFilesInParallel - kopiëren in parallelle
boolean. Facultatief. Gebruiken wanneer Destination = AzureVMs. Standaardwaarde: true.

Als u de standaardinstelling accepteert, worden bestanden parallel gekopieerd naar de doel-VM's.


CleanTargetBeforeCopy - doel opschonen
boolean. Facultatief. Gebruiken wanneer Destination = AzureVMs. Standaardwaarde: false.

Als u deze waarde instelt op true wordt de doelmap opgeschoond voordat u de kopieeractie uitvoert.


skipCACheck - certificaat testen
boolean. Facultatief. Gebruiken wanneer Destination = AzureVMs. Standaardwaarde: true.

De standaardwaarde valideert niet dat het servercertificaat is ondertekend door een vertrouwde CERTIFICERINGsinstantie voordat u verbinding maakt via HTTPS.


outputStorageUri - Storage Container URI-
string.

Geef de naam op van de variabele die wordt gebruikt voor de opslagcontainer-URI waarnaar bestanden zijn gekopieerd. Alleen geldig wanneer de geselecteerde bestemming een Azure Blob is.


outputStorageContainerSasToken - SAS-token voor opslagcontainers
string.

Geef de naam op van de variabele die wordt gebruikt voor het SAS-token van de opslagcontainer dat toegang heeft tot de bestanden die zijn gekopieerd. Alleen geldig wanneer de geselecteerde bestemming een Azure Blob is.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Wat is er nieuw in versie 2.0: Nieuwere versie van AzCopy gebruiken.

Vereisten

Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen om taken uit te voeren die gebruikmaken van deze taak: azureps:
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Welk dan ook
variabelen instellen Welk dan ook
Agentversie 1.103.0 of hoger
Taakcategorie Implementeren