WindowsMachineFileCopy@2 - Attività copia file del computer Windows v2

Articolo
07/02/2024

Usare questa attività per copiare i file nei computer Windows remoti.

Sintassi

# Windows machine file copy v2
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    MachineNames: # string. Required. Machines. 
    AdminUserName: # string. Required. Admin Login. 
    AdminPassword: # string. Required. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

# Windows machine file copy v2
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #MachineNames: # string. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

# Windows Machine File Copy v2
# Copy files to remote machine(s).
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #MachineNames: # string. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

Input

SourcePath - Fonte
string. Obbligatorio.

Percorso dei file da copiare. Specifica il percorso assoluto della cartella di origine o del file nel computer locale o in una condivisione UNC, ad esempio c:\fabrikamfiber o \\fabrikamshare\fabrikamfiber. È possibile usare variabili di sistema predefinite, ad esempio $(Build.Repository.LocalPath) (la cartella di lavoro nel computer agente), che semplifica la specifica del percorso degli artefatti di compilazione nel computer che ospita l'agente di automazione.

MachineNames - Macchine
string. Obbligatorio.

Specifica un elenco delimitato da virgole di indirizzi IP del computer o FQDN, facoltativamente incluso il numero di porta.
Ad esempio, dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 è possibile specificare anche la variabile di output di altre attività, ad esempio $(variableName), oppure è possibile usare il nome di un gruppo di risorse di Azure.

MachineNames - Macchine
string.

Specifica un elenco delimitato da virgole di indirizzi IP del computer o FQDN, facoltativamente incluso il numero di porta. Ad esempio: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34. È anche possibile specificare la variabile di output di altre attività, ad esempio $(variableName), oppure è possibile usare il nome di un gruppo di risorse di Azure.

AdminUserName - Amministrazione account di accesso
string. Obbligatorio.

Specifica il nome utente di un dominio o un account amministrativo locale negli host di destinazione. Sono supportati formati come domain\username, username e machine-name\username . I formati UPN, ad esempio , e gli account di sistema predefiniti, ad esempio username@domain.comNT Authority\System, non sono supportati.

AdminUserName - Amministrazione account di accesso
string.

AdminPassword - Password
string. Obbligatorio.

Specifica la password per l'account di accesso dell'amministratore per i computer di destinazione. Le variabili definite nelle pipeline di compilazione o di rilascio, ad esempio $(passwordVariable), sono accettate. È possibile contrassegnare la variabile come secret proteggere la variabile.

AdminPassword - Password
string.

TargetPath - Cartella di destinazione
string. Obbligatorio.

Specifica il percorso locale nei computer di destinazione o un percorso UNC accessibile per copiare i file dall'origine, ad esempio d:\fabrikam o \\fabrikam\Web.

CleanTargetBeforeCopy - Destinazione pulita
boolean. Valore predefinito: false.

Elimina tutti i file nella cartella di destinazione prima di copiare i nuovi file.

CopyFilesInParallel - Copiare file in parallelo
boolean. Valore predefinito: true.

Copia i file in tutti i computer di destinazione in parallelo, che possono velocizzare il processo di copia.

AdditionalArguments - Argomenti aggiuntivi
string.

Specifica altri argomenti Di RoboCopy applicati durante la copia di file, ad esempio /min:33553332 /l.

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 copiare i file dell'applicazione e altri artefatti, ad esempio script di PowerShell e moduli PowerShell-DSC, necessari per installare l'applicazione nei computer Windows. Usa RoboCopy, l'utilità della riga di comando compilata per la copia rapida dei dati.

Perché viene visualizzato un errore di sistema 53 quando si usa questa attività?

In genere si verifica quando non è possibile trovare il percorso specificato. Ciò può essere dovuto a un firewall che blocca le porte necessarie per la condivisione file e stampante o una specifica del percorso non valida. Per altre informazioni, vedere Errore 53 in TechNet.

Novità della versione 2.0

Il supporto proxy viene aggiunto.
Rimozione del supporto dei computer DTL legacy.

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	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	1.104.0 o versione successiva
Categoria attività	Distribuire

Condividi tramite