AzureFileCopy@1 - Azure-taak voor het kopiëren van bestanden v1

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 v1
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@1
  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. 
    #AdditionalArguments: # string. Additional Arguments. 
    #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 van 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.

Voorbeeld: geef voor de doellocatie https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/de containernaam mycontainer en het blobvoorvoegsel op: vd1/vd2.

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 een VM-hostnaam of -tag 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 alleen uitgevoerd op de 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 voor het kopiëren van bestanden uit de bron.

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

AdditionalArguments - Aanvullende argumenten
string.

Geef aanvullende argumenten op AzCopy.exe die worden toegepast bij het uploaden naar blobs of VM's zoals /NC:10.

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

Indien ingeschakeld, wordt een zelfondertekend certificaat gebruikt 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 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 of het servercertificaat is ondertekend door een vertrouwde CA voordat verbinding werd 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.

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