AzureFileCopy@1 - Attività copia file di Azure v1
Copiare i file in Archiviazione BLOB di Azure o macchine virtuali.
Nota
Questa attività non supporta l'autenticazione di Azure Resource Manager con la federazione delle identità del flusso di lavoro.
Sintassi
# 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.
# Azure File Copy v1
# Copy files to Azure blob or VM(s).
- 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.
Input
SourcePath
- Fonte
string
. Obbligatorio.
Specificare il percorso assoluto della cartella di origine, del file nel computer locale o di una condivisione UNC. Il valore o l'espressione specificati devono restituire un singolo nome di cartella o un nome file.
azureConnectionType
- Tipo di connessione di Azure
Alias di input: ConnectedServiceNameSelector
. string
. Valori consentiti: ConnectedServiceName
(versione classica di Azure), ConnectedServiceNameARM
(Azure Resource Manager). Valore predefinito: ConnectedServiceNameARM
.
Specificare il tipo di connessione di Azure.
azureClassicSubscription
- Sottoscrizione classica di Azure
Alias di input: ConnectedServiceName
. string
. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceName
.
Specificare la sottoscrizione classica di Azure di destinazione.
azureSubscription
- Sottoscrizione di Azure
Alias di input: ConnectedServiceNameARM
. string
. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceNameARM
.
Specificare la sottoscrizione di Azure Resource Manager di destinazione.
Destination
- Tipo di destinazione
string
. Obbligatorio. Valori consentiti: AzureBlob
(BLOB di Azure), AzureVMs
(macchine virtuali di Azure).
Specificare il tipo di destinazione da utilizzare per copiare i file.
classicStorage
- Account di archiviazione classico
Alias di input: StorageAccount
. string
. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceName
.
Specificare un account di archiviazione classico preesistente. Si tratta dell'account di archiviazione usato come intermediario per copiare i file in macchine virtuali di Azure.
storage
- Account di archiviazione RM
Alias di input: StorageAccountRM
. string
. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceNameARM
.
Specificare un account di archiviazione ARM preesistente. Si tratta dell'account di archiviazione usato come intermediario per copiare i file in macchine virtuali di Azure.
ContainerName
- Nome contenitore
string
. Obbligatorio quando Destination = AzureBlob
.
Specificare il nome del contenitore in cui vengono copiati i file. Se il contenitore specificato non esiste nell'account di archiviazione, verrà creato.
Per creare una directory virtuale all'interno del contenitore, usare l'input del prefisso BLOB.
Esempio: per il percorso https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/
di destinazione , specificare il nome mycontainer
del contenitore e il prefisso BLOB: vd1/vd2
.
BlobPrefix
- Prefisso BLOB
string
. facoltativo. Usare quando Destination = AzureBlob
.
Specificare un prefisso che può essere usato per filtrare i file.
Esempio: è possibile aggiungere un numero di build per filtrare i file da tutti i BLOB con lo stesso numero di build.
Esempio: se si specifica un prefisso myvd1
BLOB , viene creata una directory virtuale all'interno del contenitore. I file vengono copiati dall'origine a https://myaccount.blob.core.windows.net/mycontainer/myvd1/
.
cloudService
- Servizio cloud
Alias di input: EnvironmentName
. string
. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs
.
Specificare il nome del servizio cloud di destinazione.
resourceGroup
- Gruppo di risorse
Alias di input: EnvironmentNameRM
. string
. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs
.
Specificare il nome del gruppo di risorse di destinazione.
ResourceFilteringMethod
- Selezionare Computer per
string
. facoltativo. Usare quando Destination = AzureVMs
. Valori consentiti: machineNames
(Nomi computer), tags
. Valore predefinito: machineNames
.
Specificare un nome host o un tag della macchina virtuale che identifica un subset di macchine virtuali in un gruppo di risorse. I tag sono supportati solo per le risorse create tramite il Resource Manager di Azure.
MachineNames
- Criteri di filtro
string
. facoltativo. Usare quando Destination = AzureVMs
.
Specificare un elenco di nomi host di macchine virtuali di Azure, ad ffweb
esempio , ffdb
o tag, Role:DB
ad esempio , Web
, OS:Win8.1
.
Nota: i delimitatori validi per i tag includono ,(virgola), :(colon) e ;(semicolon). Quando si specificano più tag, l'attività verrà eseguita solo nelle macchine virtuali che contengono i tag specificati. Per impostazione predefinita, l'attività viene eseguita in tutte le macchine virtuali.
vmsAdminUserName
- account di accesso Amministrazione
string
. Obbligatorio quando Destination = AzureVMs
.
Specificare il nome utente dell'account amministratore della macchina virtuale di Azure.
vmsAdminPassword
- Password
string
. Obbligatorio quando Destination = AzureVMs
.
Specificare la password per l'account amministratore della macchina virtuale di Azure.
L'input valido include variabili definite nelle pipeline di compilazione o versione, $(passwordVariable)
ad esempio . Per proteggere una password, contrassegnarla come secret
.
TargetPath
- Cartella di destinazione
string
. Obbligatorio quando Destination = AzureVMs
.
Specificare il percorso locale nelle macchine virtuali di destinazione per copiare i file dall'origine.
L'input valido include variabili di ambiente, ad $env:windir\BudgetIT\Web
esempio .
AdditionalArguments
- Argomenti aggiuntivi
string
.
Fornire argomenti aggiuntivi a AzCopy.exe
che verranno applicati durante il caricamento in BLOB o macchine virtuali, ad esempio , /NC:10
.
enableCopyPrerequisites
- Abilitare i prerequisiti di copia
boolean
. facoltativo. Usare quando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs
. Valore predefinito: false
.
Se abilitata, usa un certificato autofirmato per configurare un listener di Gestione remota Windows (WinRM) sulla porta 5986 anziché sul protocollo HTTPS. Obbligatorio per l'esecuzione di operazioni di copia nelle macchine virtuali di Azure. Se le macchine virtuali di destinazione usano un servizio di bilanciamento del carico, configurare le regole NAT in ingresso per la porta di destinazione (5986). Si applica solo per le macchine virtuali ARM.
CopyFilesInParallel
- Copia in parallelo
boolean
. facoltativo. Usare quando Destination = AzureVMs
. Valore predefinito: true
.
Accettando l'impostazione predefinita, i file vengono copiati in parallelo alle macchine virtuali di destinazione.
CleanTargetBeforeCopy
- Destinazione pulita
boolean
. facoltativo. Usare quando Destination = AzureVMs
. Valore predefinito: false
.
L'impostazione su true
pulisce la cartella di destinazione prima di eseguire l'azione di copia.
skipCACheck
- Testare il certificato
boolean
. facoltativo. Usare quando Destination = AzureVMs
. Valore predefinito: true
.
Il valore predefinito non verrà convalidato se il certificato del server è stato firmato da una CA attendibile prima della connessione tramite HTTPS.
outputStorageUri
- URI contenitore di archiviazione
string
.
Specificare il nome della variabile usata per l'URI del contenitore di archiviazione in cui sono stati copiati i file. Valido solo quando la destinazione selezionata è un BLOB di Azure.
outputStorageContainerSasToken
- Token di firma di accesso condiviso del contenitore di archiviazione
string
.
Specificare il nome della variabile usata per il token di firma di accesso condiviso del contenitore di archiviazione che accede ai file copiati. Valido solo quando la destinazione selezionata è un BLOB di Azure.
Opzioni di controllo delle attività
Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.
Variabili di output
Nessuno.
Requisiti
Requisito | Descrizione |
---|---|
Tipi di pipeline | YAML, build classica, versione classica |
Viene eseguito in | Agente, DeploymentGroup |
Richieste | Gli agenti self-hosted devono avere funzionalità che soddisfano le richieste seguenti per eseguire processi che usano questa attività: azureps |
Capabilities | Questa attività non soddisfa le richieste per le attività successive nel processo. |
Restrizioni dei comandi | Qualsiasi |
Variabili impostabili | Qualsiasi |
Versione agente | 1.103.0 o versione successiva |
Categoria attività | Distribuire |