AzureFileCopy@6 – Azure-filkopiering v6-uppgift

Kopiera filer till Azure Blob Storage eller virtuella datorer.

Den här versionen av uppgiften stöder arbetsbelastningsidentitetsfederation och använder Azure RBAC för att få åtkomst till Azure Storage. Som ett resultat av att vi använder Azure RBAC används inte längre SAS-token. Mer information finns i avsnittet Kommentarer .

# Azure file copy v6
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@6
  inputs:
    SourcePath: # string. Required. Source. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    storage: # string. Alias: StorageAccountRM. Required. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when 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 Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
    #CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.

SourcePath - Källkod
string. Krävs.

Platsen för källfiler. Värden som stöds är YAML-pipelines och klassisk version som stöder fördefinierade systemvariabler som Build.Repository.LocalPath.

Versionsvariabler stöds endast i klassiska versioner. Jokertecknet (*) stöds var som helst i filsökvägen eller filnamnet.

Uttrycket ska returnera en enskild mapp eller en fil.

azureSubscription - Azure-prenumeration
Indataalias: ConnectedServiceNameARM. string. Krävs.

Ange namnet på en Azure Resource Manager-tjänstanslutning som konfigurerats för prenumerationen där azure-måltjänsten, den virtuella datorn eller lagringskontot finns. Mer information finns i Översikt över Azure Resource Manager.

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

Ange måltyp.

storage - RM Storage-konto
Indataalias: StorageAccountRM. string. Krävs.

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.

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ålplatsen https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/anger du till exempel containernamn mycontainer och blobprefix: vd1/vd2.

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

Ange ett prefix för den virtuella målkatalogen i Azure Blob-containern. Detta gäller när SourcePath innehåller ett jokertecken som kan matcha flera objekt.

Exempel: Du kan lägga till ett byggnummer för att prefixa 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/.

Om SourcePath är ett enskilt objekt utan jokertecken fungerar det här blobprefixet som målblobnamn.

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

Ange namnet på målresursgruppen som filerna ska kopieras till.

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

Ange ett värdnamn eller tagg för virtuell dator 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 namn på virtuella datorer eller taggnamn som identifierar de virtuella datorer som uppgiften ska riktas mot. Giltiga filtervillkor omfattar:

• Namnet på en Azure-resursgrupp.
• En utdatavariabel från en tidigare aktivitet.
• En kommaavgränsad lista över taggnamn eller VM-namn.
• Formatera VM-namn med hjälp av en kommaavgränsad lista över FQDN:er eller IP-adresser.
• Formatera taggnamn för ett filter som {TagName}:{Value} exempel: Role:DB;OS:Win8.1

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

Ange användarnamnet för ett konto med administratörsbehörighet för alla virtuella måldatorer.

• Format som stöds är: username, domain\username, machine-name\usernameoch .\username.
• UPN-format inklusive username@domain.com och inbyggda systemkonton som NT Authority\System inte stöds.

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

Ange lösenordet för parametern Admin Login .

Leta reda på parametern för att hitta variabeln Admin Login . Välj hänglåsikonen för en variabel som definierats på Variables fliken för att skydda värdet och infoga variabelnamnet här.

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

Ange sökvägen till mappen på de virtuella Azure-datorer som filerna ska kopieras till.

Miljövariabler som $env:windir och $env:systemroot stöds. Exempel: $env:windir\FabrikamFiber\Web och c:\FabrikamFiber

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

Ange ytterligare argument som ska AzCopy.exe användas när du laddar upp till bloben och laddar ned till de virtuella datorerna. Mer information finns i Överföra data med Verktyget AzCopy Command-Line .

För Premium-lagringskonton som endast stöder Azure-sidblobar används --blob-type=PageBlob som ytterligare ett argument.

Standardargument inkluderar --log-level=INFO (standard) och --recursive (om containernamnet inte $rootär ).

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 AzCopy.exe ska användas vid nedladdning till virtuella datorer, --check-length=truetill exempel .

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

• --log-level=INFO
• --log-level=DEBUG (Om pipelinen körs i felsökningsläge inställd)
• --recursive

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

När det här alternativet är aktiverat använder det här alternativet ett självsignerat certifikat för att konfigurera WinRM-lyssnaren (Windows Remote Management) via HTTPS-protokollet på port 5986. Den här konfigurationen krävs för att utföra kopieringsåtgärder på virtuella Azure-datorer. Gäller endast för virtuella ARM-datorer.

• Om de virtuella måldatorerna nås via en lastbalanserare konfigurerar du en inkommande NAT-regel för att tillåta åtkomst på port 5986.
• Om de virtuella måldatorerna är associerade med en nätverkssäkerhetsgrupp (NSG) konfigurerar du en inkommande säkerhetsregel för att tillåta åtkomst på port 5986.

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

Ange true att filer ska kopieras parallellt till de virtuella måldatorerna.

CleanTargetBeforeCopy - Rensa mål
boolean. Standardvärde: false.

Ange true för att rensa målmappen innan du kopierar filer.

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

WinRM kräver ett certifikat för HTTPS-överföringen när filer kopieras från den mellanliggande lagringsbloben till de virtuella Azure-datorerna.

Om du använder ett självsignerat certifikat anger du true för att förhindra att processen verifierar certifikatet med en betrodd certifikatutfärdare.

Den här aktiviteten definierar följande utdatavariabler, som du kan använda i underordnade steg, jobb och faser.

StorageContainerUri
URI för containern där filerna kopierades till. Endast giltig när det valda målet är Azure Blob.