AzureFileCopy@2 – Azure-filkopiering v2-uppgift

Kopiera filer till Azure Blob Storage eller virtuella datorer.

Anteckning

Den här uppgiften stöder inte Azure Resource Manager-autentisering med arbetsflödesidentitetsfederation.

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.

Indata

SourcePath - Källkod
string. Krävs.

Ange den absoluta sökvägen till källmappen, filen på den lokala datorn eller en UNC-resurs. Det angivna värdet eller uttrycket ska returnera antingen ett enskilt mappnamn eller ett filnamn.

azureConnectionType - Azure-anslutningstyp
Indataalias: ConnectedServiceNameSelector. string. Tillåtna värden: ConnectedServiceName (Klassisk Azure) ConnectedServiceNameARM (Azure Resource Manager). Standardvärde: ConnectedServiceNameARM.

Ange Anslutningstyp för Azure.

azureClassicSubscription - Klassisk Azure-prenumeration
Indataalias: ConnectedServiceName. string. Krävs när ConnectedServiceNameSelector = ConnectedServiceName.

Ange den klassiska målprenumerationen för Azure.

azureSubscription - Azure-prenumeration
Indataalias: ConnectedServiceNameARM. string. Krävs när ConnectedServiceNameSelector = ConnectedServiceNameARM.

Ange azure Resource Manager-målprenumerationen.

Destination - Måltyp
string. Krävs. Tillåtna värden: AzureBlob (Azure Blob), AzureVMs (virtuella Azure-datorer).

Ange den måltyp som ska användas för att kopiera filerna.

classicStorage - Klassiskt lagringskonto
Indataalias: StorageAccount. string. Krävs när ConnectedServiceNameSelector = ConnectedServiceName.

Ange ett befintligt klassiskt lagringskonto. Det här är lagringskontot som används som mellanhand för att kopiera filer till virtuella Azure-datorer.

storage - RM Storage-konto
Indataalias: StorageAccountRM. string. Krävs när ConnectedServiceNameSelector = ConnectedServiceNameARM.

Ange ett befintligt ARM-lagringskonto. Det här är lagringskontot som används som mellanhand för att kopiera filer till virtuella Azure-datorer.

ContainerName - Containernamn
string. Krävs när Destination = AzureBlob.

Ange namnet på containern som filerna kopieras till. Om den angivna containern inte finns i lagringskontot skapas den.

Om du vill skapa en virtuell katalog i containern använder du blobprefixindata. För målplats https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/anger du till exempel containernamnet mycontainer och blobprefixet vd1/vd2.

BlobPrefix - Blobprefix
string. Valfritt. Använd när Destination = AzureBlob.

Ange ett prefix som kan användas för att filtrera filer.

Exempel: Du kan lägga till ett byggnummer för att filtrera filerna från alla blobar med samma versionsnummer.

Exempel: Om du anger ett blobprefix myvd1skapas en virtuell katalog i containern. Filer kopieras från källan till https://myaccount.blob.core.windows.net/mycontainer/myvd1/.

cloudService - Molntjänst
Indataalias: EnvironmentName. string. Krävs när ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Ange namnet på molntjänsten för målet.

resourceGroup - Resursgrupp
Indataalias: EnvironmentNameRM. string. Krävs när ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

Ange namnet på målresursgruppen.

ResourceFilteringMethod - Välj Datorer efter
string. Valfritt. Använd när Destination = AzureVMs. Tillåtna värden: machineNames (Datornamn), tags. Standardvärde: machineNames.

Ange värdnamnet eller taggen för den virtuella datorn som identifierar en delmängd av virtuella datorer i en resursgrupp. Taggar stöds endast för resurser som skapats via Azure Resource Manager.

MachineNames - Filtervillkor
string. Valfritt. Använd när Destination = AzureVMs.

Ange en lista över värdnamn för virtuella Azure-datorer, ffwebtill exempel , ffdbeller taggar som Role:DB, Web. OS:Win8.1

Obs! Giltiga avgränsare för taggar inkluderar ,(kommatecken), :(kolon) och ;(semikolon). När du tillhandahåller flera taggar körs uppgiften på alla virtuella datorer som innehåller de angivna taggarna. Som standard körs aktiviteten på alla virtuella datorer.

vmsAdminUserName - Admin inloggning
string. Krävs när Destination = AzureVMs.

Ange användarnamnet för administratörskontot för den virtuella Azure-datorn.

vmsAdminPassword - Lösenord
string. Krävs när Destination = AzureVMs.

Ange lösenordet för administratörskontot för den virtuella Azure-datorn.

Giltiga indata innehåller variabler som definierats i bygg- eller versionspipelines, till exempel $(passwordVariable). Om du vill skydda ett lösenord markerar du det som secret.

TargetPath - Målmappen
string. Krävs när Destination = AzureVMs.

Ange den lokala sökvägen på de virtuella måldatorerna.

Giltiga indata innehåller miljövariabler som $env:windir\BudgetIT\Web.

AdditionalArgumentsForBlobCopy - Valfria argument (för att ladda upp filer till blob)
string.

Ange ytterligare argument som kan användas vid uppladdning till blobar, /NC:10till AzCopy.exe exempel .

Om inga valfria argument anges läggs följande argument till som standard.

• /Y
• /SetContentType
• /Z
• /V
• /S – Läggs till när containernamnet inte $rootär .
• /BlobType:page – Läggs till när det angivna lagringskontot är ett Premium-konto.
• /Pattern – Läggs till när källsökvägen är en fil. Ingår i andra angivna valfria argument.

AdditionalArgumentsForVMCopy - Valfria argument (för att ladda ned filer till en virtuell dator)
string. Valfritt. Använd när Destination = AzureVMs.

Ange ytterligare argument som kan användas när du laddar ned till virtuella datorer, till AzCopy.exe exempel /NC:10.

Om inga valfria argument anges läggs följande till som standard.

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

enableCopyPrerequisites - Aktivera krav för kopiering
boolean. Valfritt. Använd när ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Standardvärde: false.

När det är aktiverat använder du ett självsignerat certifikat för att konfigurera en WinRM-lyssnare (Windows Remote Management) på port 5986 i stället för HTTPS-protokollet. Krävs för att utföra kopieringsåtgärder på virtuella Azure-datorer. Om de virtuella måldatorerna använder en lastbalanserare konfigurerar du inkommande NAT-regler för målporten (5986). Gäller endast för virtuella ARM-datorer.

CopyFilesInParallel - Kopiera parallellt
boolean. Valfritt. Använd när Destination = AzureVMs. Standardvärde: true.

Om du accepterar standardinställningen kopieras filer parallellt med de virtuella måldatorerna.

CleanTargetBeforeCopy - Rensa mål
boolean. Valfritt. Använd när Destination = AzureVMs. Standardvärde: false.

Om du anger det här värdet rensas true målmappen innan kopieringsåtgärden utförs.

skipCACheck - Testcertifikat
boolean. Valfritt. Använd när Destination = AzureVMs. Standardvärde: true.

Standardvärdet verifierar inte att servercertifikatet signerades av en betrodd certifikatutfärdare innan du ansluter via HTTPS.

outputStorageUri - URI för lagringscontainer
string.

Ange namnet på variabeln som används för lagringscontainerns URI som filerna kopierades till. Endast giltigt när det valda målet är en Azure Blob.

outputStorageContainerSasToken - SAS-token för lagringscontainer
string.

Ange namnet på variabeln som används för lagringscontainerns SAS-token som kommer åt filerna som kopierades. Endast giltigt när det valda målet är en Azure Blob.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Nyheter i version 2.0: Använda nyare version av AzCopy.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Lokalt installerade agenter måste ha funktioner som matchar följande krav för att köra jobb som använder den här uppgiften: azureps
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	1.103.0 eller senare
Uppgiftskategori	Distribuera