次の方法で共有


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.

入力

SourcePath - ソース
string。 必須。

コピーするファイルへのパス。 c:\fabrikamfiber\\fabrikamshare\fabrikamfiberなど、ローカル コンピューターまたは UNC 共有上のソース フォルダーまたはファイルの絶対パスを指定します。 $(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\usernameusernamemachine-name\username などの形式がサポートされています。 UPN 形式 ( username@___domain.com など) と、組み込みのシステム アカウント ( NT Authority\System など) はサポートされていません。


AdminUserName - 管理者ログイン
string

ターゲット ホスト上のドメインまたはローカル管理アカウントのユーザー名を指定します。 ___domain\usernameusernamemachine-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

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


タスク制御オプション

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

出力変数

なし。

注釈

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

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

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

バージョン 2.0 の新機能

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

要求事項

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