AzureFileCopy@2 - Azure-taak voor het kopiëren van bestanden v2

Bestanden kopiëren naar Azure Blob Storage of virtuele machines.

Notitie

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

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.

Invoerwaarden

SourcePath - Bron
string. Vereist.

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

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

Geef het Azure-verbindingstype op.

azureClassicSubscription - Klassiek 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. Vereist. 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 waarnaar 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. Optioneel. Gebruik 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 Blob-voorvoegsel myvd1opgeeft, 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. Optioneel. Gebruik wanneer Destination = AzureVMs. Toegestane waarden: machineNames (Computernamen), tags. Standaardwaarde: machineNames.

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

MachineNames - Filtercriteria
string. Optioneel. Gebruik wanneer Destination = AzureVMs.

Geef een lijst op met azure-VM-hostnamen, 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 - Beheer aanmelden
string. Vereist wanneer Destination = AzureVMs.

Geef de gebruikersnaam van het Azure VM-beheerdersaccount op.

vmsAdminPassword - Wachtwoord
string. Vereist wanneer Destination = AzureVMs.

Geef het wachtwoord op voor het Azure VM-beheerdersaccount.

Geldige invoer omvat 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 omvat omgevingsvariabelen zoals $env:windir\BudgetIT\Web.

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

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

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

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

AdditionalArgumentsForVMCopy - Optionele argumenten (voor het downloaden van bestanden naar VM)
string. Optioneel. Gebruik wanneer Destination = AzureVMs.

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

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

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

enableCopyPrerequisites - Vereisten voor kopiëren inschakelen
boolean. Optioneel. Gebruik wanneer ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Standaardwaarde: false.

Indien 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 - Parallel kopiëren
boolean. Optioneel. Gebruik wanneer Destination = AzureVMs. Standaardwaarde: true.

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

CleanTargetBeforeCopy - Doel opschonen
boolean. Optioneel. Gebruik wanneer Destination = AzureVMs. Standaardwaarde: false.

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

skipCACheck - Testcertificaat
boolean. Optioneel. Gebruik wanneer Destination = AzureVMs. Standaardwaarde: true.

De standaardwaarde valideert niet dat het servercertificaat is ondertekend door een vertrouwde CA voordat verbinding wordt gemaakt via HTTPS.

outputStorageUri - URI van opslagcontainer
string.

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

outputStorageContainerSasToken - SAS-token voor opslagcontainer
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 als de geselecteerde bestemming een Azure-blob is.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

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

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die gebruikmaken van deze taak: azureps
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	1.103.0 of hoger
Taakcategorie	Implementeren