次の方法で共有

WindowsMachineFileCopy@2 - Windows マシン ファイル コピー v2 タスク

  • [アーティクル]

このタスクを使用して、リモート Windows マシンにファイルをコピーします。

構文

# 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.

入力

SourcePath - ソース
string. 必須です。

コピーするファイルのパス。 など、ローカル コンピューターまたは UNC 共有 c:\fabrikamfiber 上のソース フォルダーまたはファイルの絶対パスを指定します \\fabrikamshare\fabrikamfiber。 (エージェント コンピューター上の作業フォルダー) などの $(Build.Repository.LocalPath) 定義済みのシステム変数を使用すると、オートメーション エージェントをホストするコンピューター上のビルド成果物の場所を簡単に指定できます。


MachineNames - マシン
string. 必須です。

必要に応じて、ポート番号を含む、コンピューターの IP アドレスまたは FQDN のコンマ区切りの一覧を指定します。
たとえば、 dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 などの $(variableName)他のタスクの出力変数を指定することも、 Azure リソース グループの名前を使用することもできます。


MachineNames - マシン
string.

必要に応じて、ポート番号を含む、コンピューターの IP アドレスまたは FQDN のコンマ区切りの一覧を指定します。 (例: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34)。 他のタスクの出力変数 (例: $(variableName)) を指定することも、 Azure リソース グループの名前を使用することもできます。


AdminUserName - 管理 ログイン
string. 必須です。

ターゲット ホスト上のドメインまたはローカル管理アカウントのユーザー名を指定します。 domain\username、username、machine-name\username などの形式がサポートされています。 などの UPN 形式 username@domain.comと、 NT Authority\System などの組み込みのシステム アカウントはサポートされていません。


AdminUserName - 管理 ログイン
string.

ターゲット ホスト上のドメインまたはローカル管理アカウントのユーザー名を指定します。 domain\username、username、machine-name\username などの形式がサポートされています。 などの UPN 形式 username@domain.comと、 NT Authority\System などの組み込みのシステム アカウントはサポートされていません。


AdminPassword - パスワード
string. 必須です。

ターゲット マシンの管理者ログインのパスワードを指定します。 ビルドまたはリリース パイプラインで定義されている変数 (など $(passwordVariable)) が受け入れられます。 変数 secret を としてマークして、セキュリティで保護できます。


AdminPassword - パスワード
string.

ターゲット マシンの管理者ログインのパスワードを指定します。 ビルドまたはリリース パイプラインで定義されている変数 (など $(passwordVariable)) が受け入れられます。 変数 secret を としてマークして、セキュリティで保護できます。


TargetPath - 移動先フォルダー
string. 必須です。

ターゲット マシン上のローカル パス、または ソースからファイルをコピーするためのアクセス可能な UNC パス (、 などd:\fabrikam\\fabrikam\Web) を指定します。


CleanTargetBeforeCopy - クリーン ターゲット
boolean. 既定値: false。

新しいファイルをコピーする前に、ターゲット フォルダー内のすべてのファイルを削除します。


CopyFilesInParallel - 並列でファイルをコピーする
boolean. 既定値: true。

すべてのターゲット マシンにファイルを並列にコピーします。これにより、コピー プロセスが高速化されます。


AdditionalArguments - その他の引数
string.

などの /min:33553332 /lファイルをコピーするときに適用される追加の RoboCopy 引数を指定します。


タスク コントロール のオプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

このタスクを使用して、アプリケーション ファイルや、Windows マシンにアプリケーションをインストールするために必要な PowerShell スクリプトや PowerShell-DSC モジュールなどの他の成果物をコピーします。 データの高速コピー用に構築されたコマンドライン ユーティリティである RoboCopy を使用します。

このタスクを使用すると、システム エラー 53 が発生するのはなぜですか?

通常、これは、指定したパスが見つからない場合に発生します。 これは、ファイアウォールがファイルとプリンターの共有に必要なポートをブロックしているか、パス指定が無効であることが原因である可能性があります。 詳細については、「TechNet の エラー 53 」を参照してください。

バージョン 2.0 の新機能

  • プロキシのサポートが追加されています。
  • レガシ DTL マシンのサポートが削除されました。

要件

要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
実行日 エージェント、DeploymentGroup
確認要求 なし
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン 1.104.0 以上
タスクのカテゴリ 配置