DownloadSecureFile@1 - Beveiligd bestand v1-taak downloaden

Gebruik deze taak om een beveiligd bestand naar de agentcomputer te downloaden.

Syntaxis

# Download secure file v1
# Download a secure file to the agent machine.
- task: DownloadSecureFile@1
  inputs:
    secureFile: # string. Required. Secure File. 
    #retryCount: '8' # string. Retry Count. Default: 8.
    #socketTimeout: # string. Socket Timeout.

Invoer

secureFile - secure file
string. Verplicht.

Hiermee geeft u de naam of unieke id (GUID) van het beveiligde bestand dat wordt gedownload naar de agentcomputer. Het bestand wordt verwijderd wanneer de pijplijntaak is voltooid.

retryCount - Aantal nieuwe pogingen
string. Standaardwaarde: 8.

Facultatief. Hiermee geeft u het aantal keren op om een beveiligd bestand opnieuw te downloaden als het downloaden mislukt.

socketTimeout - sockettime-out
string.

Facultatief. Bij het downloaden van een beveiligde bestandsaanvraag in Microsoft geeft deze invoer de time-out voor een socket op.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Deze taak definieert de volgende uitvoervariabelen, die u kunt gebruiken in downstreamstappen, taken en fasen.

secureFilePath
Geeft de locatie op van het beveiligde bestand dat is gedownload.

Opmerkingen

Gebruik deze taak in een pijplijn om een beveiligd bestand te downloaden naar de agentcomputer. Wanneer u de naam van het bestand opgeeft (met behulp van de secureFile invoer), gebruikt u de naam die u hebt opgegeven bij het uploaden, in plaats van de werkelijke bestandsnaam.

Notitie

Deze taak wordt uitgevoerd aan het begin van de fase, ongeacht waar deze zich in de taak bevindt.

Nadat u het bestand hebt gedownload, gebruikt u de name waarde die is ingesteld voor de taak (of 'Verwijzingsnaam' in de klassieke editor) om te verwijzen naar het pad naar het beveiligde bestand op de agentcomputer. Als de taak bijvoorbeeld de naam mySecureFilekrijgt, kan in de pijplijn naar het pad worden verwezen als $(mySecureFile.secureFilePath). U kunt ook gedownloade beveiligde bestanden vinden in de map die is opgegeven door $(Agent.TempDirectory). Zie een volledig voorbeeld hieronder.

Wanneer de pijplijntaak is voltooid, of deze nu slaagt, mislukt of wordt geannuleerd, wordt het beveiligde bestand verwijderd van de downloadlocatie.

Het is niet nodig om deze taak te gebruiken met de Apple Certificate installeren of Apple-inrichtingsprofiel installeren taken omdat ze automatisch het beveiligde bestand downloaden, installeren en verwijderen (aan het einde van de pijplijntaak).

Deze taak ondersteunt momenteel slechts één bestandstaak per exemplaar.

Voorbeelden

In dit voorbeeld wordt een beveiligd certificaatbestand gedownload en geïnstalleerd in een map met vertrouwde certificeringsinstanties (CA) op Linux:

- task: DownloadSecureFile@1
  name: caCertificate
  displayName: 'Download CA certificate'
  inputs:
    secureFile: 'myCACertificate.pem'

- script: |
    echo Installing $(caCertificate.secureFilePath) to the trusted CA directory...
    sudo chown root:root $(caCertificate.secureFilePath)
    sudo chmod a+r $(caCertificate.secureFilePath)
    sudo ln -s $(caCertificate.secureFilePath) /etc/ssl/certs/ 

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Deze taak wordt uitgevoerd met behulp van de volgende opdrachtbeperkingen: beperkt
variabelen instellen	Deze taak is gemachtigd om de volgende variabelen in te stellen : secureFilePath
Agentversie	2.182.1 of hoger
Taakcategorie	Nutsvoorzieningen