Condividi tramite


ExtractFiles@1 - Estrarre file v1 attività

Usare questa attività per estrarre un'ampia gamma di file di archiviazione e compressione, ad esempio .7z, .rar, tar.gz e .zip.

Sintassi

# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip' # string. Required. Archive file patterns. Default: **/*.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
    #overwriteExistingFiles: false # boolean. Overwrite existing files. Default: false.
    #pathToSevenZipTool: # string. Path to 7z utility.
# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip' # string. Required. Archive file patterns. Default: **/*.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
    #overwriteExistingFiles: false # boolean. Overwrite existing files. Default: false.
# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '*.zip' # string. Required. Archive file patterns. Default: *.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
# Extract Files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '*.zip' # string. Required. Archive file patterns. Default: *.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.

Input

archiveFilePatterns - Modelli di file di archiviazione
string. Obbligatorio. Valore predefinito: **/*.zip.

Specifica i percorsi o i modelli dei file di archiviazione da estrarre. Supporta più righe di modelli minimatch. Altre informazioni sull'attività Estrarre file.

Specifica i modelli che corrispondono agli archivi da estrarre. Per impostazione predefinita, i modelli iniziano nella cartella radice del repository (uguale a se è stato specificato $(Build.SourcesDirectory).
Specifica i filtri del modello, uno per riga, che corrispondono agli archivi da estrarre. Ad esempio:

  • test.zip estrae il file test.zip nella cartella radice.
  • test/*.zip estrae tutti i file .zip nella cartella di test.
  • **/*.tar estrae tutti i file tar nella cartella radice e nelle sottocartelle.
  • **/bin/*.7z estrae tutti i file con estensione 7z in qualsiasi sottocartella denominata "bin".
    Il modello viene usato per corrispondere solo ai percorsi dei file di archiviazione, non ai percorsi delle cartelle e non ai contenuti di archiviazione da estrarre. È quindi consigliabile specificare modelli, ad esempio **/bin/** anziché **/bin.

archiveFilePatterns - Modelli di file di archiviazione
string. Obbligatorio. Valore predefinito: *.zip.

Specifica i percorsi o i modelli dei file di archiviazione da estrarre. Supporta più righe di modelli minimatch. Altre informazioni sull'attività Estrarre file.


destinationFolder - Cartella di destinazione
string. Obbligatorio.

Specifica la cartella di destinazione in cui estrarre i file di archivio. Usare le variabili se i file non si trovano nel repository. Ad esempio: $(agent.builddirectory).


cleanDestinationFolder - Pulire la cartella di destinazione prima di estrarre
boolean. Valore predefinito: true.

Specifica l'opzione per pulire la directory di destinazione prima di estrarre il contenuto dell'archivio.


overwriteExistingFiles - Sovrascrivere i file esistenti
boolean. Valore predefinito: false.

Specifica l'opzione per sovrascrivere i file esistenti nella directory di destinazione se sono già presenti. Se l'opzione è false, lo script richiede file esistenti, chiedendo se si desidera sovrascriverle.


pathToSevenZipTool - Percorso dell'utilità 7z
string.

Specifica il percorso personalizzato dell'utilità 7z. Ad esempio, C:\7z\7z.exe in Windows e /usr/local/bin/7z in MacOS/Ubuntu. Se non è specificato in Windows, verrà usata la versione predefinita 7zip fornita con un'attività.


Opzioni di controllo 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

No.

Osservazioni

Usare questa attività per estrarre i file dagli archivi a una cartella di destinazione usando modelli di corrispondenza. È supportata una gamma di formati di archivio standard, tra cui .zip, .jar, .war, .ear, .tar, .7z e altro ancora.

Per altre informazioni sui modelli di corrispondenza dei file, vedere riferimento ai modelli di corrispondenza file.

Esempio

Estrarre tutti i file .zip ricorsivamente

Questo esempio estrae tutti i file .zip ricorsivamente, inclusi i file radice e i file dalle sottocartelle.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Estrarre tutti i file .zip dalla sottocartella

Questo esempio estraerà test/one.zip e test/two.zip, ma lascerà test/nested/three.zip.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: 'test/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Requisiti

Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Esecuzione in Agente, DeploymentGroup
Richieste Nessuno
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Questa attività viene eseguita usando le restrizioni di comando seguenti: limitato
Variabili impostabili Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: l'impostazione delle variabili è disabilitata
Versione agente 2.182.1 o versione successiva
Categoria attività Utilità
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Esecuzione in Agente, DeploymentGroup
Richieste Nessuno
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente Tutte le versioni dell'agente supportate.
Categoria attività Utilità

Vedi anche