次の方法で共有


AzureFileCopy@2 - Azure ファイル コピー v2 タスク

Azure Blob Storageまたは仮想マシンにファイルをコピーします。

注意

このタスクでは、ワークフロー ID フェデレーションを使用した Azure Resource Manager認証はサポートされていません。

構文

# Azure file copy v2
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    #classicStorage: # string. Alias: StorageAccount. Required when ConnectedServiceNameSelector = ConnectedServiceName. Classic Storage Account. 
    storage: # string. Alias: StorageAccountRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #cloudService: # string. Alias: EnvironmentName. Required when ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs. Cloud Service. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Resource Group. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Optional. Use when Destination = AzureVMs. Select Machines By. Default: machineNames.
    #MachineNames: # string. Optional. Use when Destination = AzureVMs. Filter Criteria. 
    #vmsAdminUserName: # string. Required when Destination = AzureVMs. Admin Login. 
    #vmsAdminPassword: # string. Required when Destination = AzureVMs. Password. 
    #TargetPath: # string. Required when Destination = AzureVMs. Destination Folder. 
    #AdditionalArgumentsForBlobCopy: # string. Optional Arguments (for uploading files to blob). 
    #AdditionalArgumentsForVMCopy: # string. Optional. Use when Destination = AzureVMs. Optional Arguments (for downloading files to VM). 
    #enableCopyPrerequisites: false # boolean. Optional. Use when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
    #CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
    #CleanTargetBeforeCopy: false # boolean. Optional. Use when Destination = AzureVMs. Clean Target. Default: false.
    #skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.
  # Output
    #outputStorageUri: # string. Storage Container URI. 
    #outputStorageContainerSasToken: # string. Storage Container SAS Token.
# Azure File Copy v2
# Copy files to Azure blob or VM(s).
- task: AzureFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    #classicStorage: # string. Alias: StorageAccount. Required when ConnectedServiceNameSelector = ConnectedServiceName. Classic Storage Account. 
    storage: # string. Alias: StorageAccountRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #cloudService: # string. Alias: EnvironmentName. Required when ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs. Cloud Service. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Resource Group. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Optional. Use when Destination = AzureVMs. Select Machines By. Default: machineNames.
    #MachineNames: # string. Optional. Use when Destination = AzureVMs. Filter Criteria. 
    #vmsAdminUserName: # string. Required when Destination = AzureVMs. Admin Login. 
    #vmsAdminPassword: # string. Required when Destination = AzureVMs. Password. 
    #TargetPath: # string. Required when Destination = AzureVMs. Destination Folder. 
    #AdditionalArgumentsForBlobCopy: # string. Optional Arguments (for uploading files to blob). 
    #AdditionalArgumentsForVMCopy: # string. Optional. Use when Destination = AzureVMs. Optional Arguments (for downloading files to VM). 
    #enableCopyPrerequisites: false # boolean. Optional. Use when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
    #CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
    #CleanTargetBeforeCopy: false # boolean. Optional. Use when Destination = AzureVMs. Clean Target. Default: false.
    #skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.
  # Output
    #outputStorageUri: # string. Storage Container URI. 
    #outputStorageContainerSasToken: # string. Storage Container SAS Token.

入力

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

ソース フォルダー、ローカル コンピューター上のファイル、または UNC 共有への絶対パスを指定します。 指定した値または式は、単一のフォルダー名またはファイル名を返す必要があります。


azureConnectionType - Azure 接続の種類
入力エイリアス: ConnectedServiceNameSelectorstring. 使用できる値: ConnectedServiceName (Azure クラシック)、 ConnectedServiceNameARM (Azure Resource Manager)。 既定値: ConnectedServiceNameARM

Azure 接続の種類を指定します。


azureClassicSubscription - Azure クラシック サブスクリプション
入力エイリアス: ConnectedServiceNamestring. ConnectedServiceNameSelector = ConnectedServiceName の場合に必要です。

ターゲットの Azure クラシック サブスクリプションを指定します。


azureSubscription - Azure サブスクリプション
入力エイリアス: ConnectedServiceNameARMstring. ConnectedServiceNameSelector = ConnectedServiceNameARM の場合に必要です。

ターゲットの Azure Resource Manager サブスクリプションを指定します。


Destination - 送信先の種類
string. 必須です。 使用できる値: AzureBlob (Azure Blob)、 AzureVMs (Azure VM)。

ファイルのコピーに使用するコピー先の種類を指定します。


classicStorage - クラシック ストレージ アカウント
入力エイリアス: StorageAccountstring. ConnectedServiceNameSelector = ConnectedServiceName の場合に必要です。

既存のクラシック ストレージ アカウントを指定します。 これは、Azure VM にファイルをコピーするための仲介役として使用されるストレージ アカウントです。


storage - RM ストレージ アカウント
入力エイリアス: StorageAccountRMstring. ConnectedServiceNameSelector = ConnectedServiceNameARM の場合に必要です。

既存の ARM ストレージ アカウントを指定します。 これは、Azure VM にファイルをコピーするための仲介役として使用されるストレージ アカウントです。


ContainerName - コンテナー名
string. Destination = AzureBlob の場合に必要です。

ファイルのコピー先となるコンテナーの名前を指定します。 指定したコンテナーがストレージ アカウントに存在しない場合は、作成されます。

コンテナー内に仮想ディレクトリを作成するには、BLOB プレフィックス入力を使用します。 たとえば、ターゲットの場所 https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/には、コンテナー名 mycontainer と BLOB プレフィックス を指定します vd1/vd2


BlobPrefix - BLOB プレフィックス
string. 省略可能。 の場合は Destination = AzureBlobを使用します。

ファイルのフィルター処理に使用できるプレフィックスを指定します。

例: ビルド番号を追加して、すべての BLOB のファイルを同じビルド番号でフィルター処理できます。

例: BLOB プレフィックス myvd1を指定すると、コンテナー内に仮想ディレクトリが作成されます。 ファイルはソースから に https://myaccount.blob.core.windows.net/mycontainer/myvd1/コピーされます。


cloudService - クラウド サービス
入力エイリアス: EnvironmentNamestring. ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs の場合に必要です。

ターゲット クラウド サービスの名前を指定します。


resourceGroup - リソース グループ
入力エイリアス: EnvironmentNameRMstring. ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs の場合に必要です。

ターゲット リソース グループの名前を指定します。


ResourceFilteringMethod - 以下の条件でコンピューターを選択
string. 省略可能。 の場合は Destination = AzureVMsを使用します。 使用できる値: machineNames (マシン名)、 tags。 既定値: machineNames

リソース グループ内の VM のサブセットを識別する VM ホスト名またはタグを指定します。 タグは、Azure Resource Manager経由で作成されたリソースでのみサポートされます。


MachineNames - フィルター条件
string. 省略可能。 の場合は Destination = AzureVMsを使用します。

、 などのタグRole:DBなどの ffdbffwebAzure VM ホスト名の一覧をWebOS:Win8.1指定します。

注: タグの有効な区切り記号には、,(コンマ)、:(コロン)、;(semicolon) があります。 複数のタグを指定すると、タスクは指定したタグを含むすべての VM で実行されます。 既定では、タスクはすべての VM で実行されます。


vmsAdminUserName - 管理者ログイン
string. Destination = AzureVMs の場合に必要です。

Azure VM 管理者アカウントのユーザー名を指定します。


vmsAdminPassword - パスワード
string. Destination = AzureVMs の場合に必要です。

Azure VM 管理者アカウントのパスワードを指定します。

有効な入力には、 などの $(passwordVariable)ビルド パイプラインまたはリリース パイプラインで定義されている変数が含まれます。 パスワードをセキュリティで保護するには、 として secretマークします。


TargetPath - ターゲット フォルダー
string. Destination = AzureVMs の場合に必要です。

ターゲット VM のローカル パスを指定します。

有効な入力には、 などの環境変数が $env:windir\BudgetIT\Web含まれます。


AdditionalArgumentsForBlobCopy - オプションの引数 (BLOB へのファイルのアップロード用)
string.

などの /NC:10BLOB にAzCopy.exeアップロードするときに適用できる に追加の引数を指定します。

省略可能な引数が指定されていない場合は、既定で次の引数が追加されます。

  • /Y
  • /SetContentType
  • /Z
  • /V
  • /S - コンテナー名が でない $root場合に追加されます。
  • /BlobType:page - 指定したストレージ アカウントが Premium アカウントの場合に追加されます。
  • /Pattern - ソース パスがファイルの場合に追加されます。 指定した他の省略可能な引数に含まれます。

AdditionalArgumentsForVMCopy - オプションの引数 (VM へのファイルのダウンロード用)
string. 省略可能。 の場合は Destination = AzureVMsを使用します。

などの /NC:10VM にAzCopy.exeダウンロードするときに適用できる に対して、追加の引数を指定します。

省略可能な引数が指定されていない場合は、既定で次が追加されます。

  • /Y
  • /S
  • /Z
  • /V

enableCopyPrerequisites - コピーの前提条件を有効にする
boolean. 省略可能。 の場合は ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMsを使用します。 既定値: false

有効にすると、自己署名証明書を使用して、HTTPS プロトコルではなくポート 5986 で Windows リモート管理 (WinRM) リスナーを構成します。 Azure VM でコピー操作を実行するために必要です。 ターゲット VM でロード バランサーを使用する場合は、ターゲット ポートの受信 NAT 規則を構成します (5986)。 ARM VM にのみ適用されます。


CopyFilesInParallel - 並列でのコピー
boolean. 省略可能。 の場合は Destination = AzureVMsを使用します。 既定値: true

既定の設定を受け入れると、ターゲット VM に並列でファイルがコピーされます。


CleanTargetBeforeCopy - ターゲットをクリーンにする
boolean. 省略可能。 の場合は Destination = AzureVMsを使用します。 既定値: false

コピー アクションを実行する前に true 、この値を設定してコピー先フォルダーをクリーンアップします。


skipCACheck - テスト証明書
boolean. 省略可能。 の場合は Destination = AzureVMsを使用します。 既定値: true

既定値では、HTTPS 経由で接続する前に、サーバー証明書が信頼された CA によって署名されたことは検証されません。


outputStorageUri - ストレージ コンテナー URI
string.

ファイルのコピー先のストレージ コンテナー URI に使用される変数の名前を指定します。 選択した宛先が Azure BLOB の場合にのみ有効です。


outputStorageContainerSasToken - ストレージ コンテナー SAS トークン
string.

コピーされたファイルにアクセスするストレージ コンテナー SAS トークンに使用される変数の名前を指定します。 選択した宛先が Azure BLOB の場合にのみ有効です。


タスク制御オプション

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

出力変数

[なし] :

解説

バージョン 2.0 の新機能: 新しいバージョンの AzCopy の使用。

必要条件

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