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 接続の種類
入力エイリアス: ConnectedServiceNameSelector。 string. 使用できる値: ConnectedServiceName (Azure クラシック)、 ConnectedServiceNameARM (Azure Resource Manager)。 既定値: ConnectedServiceNameARM。
Azure 接続の種類を指定します。
azureClassicSubscription - Azure クラシック サブスクリプション
入力エイリアス: ConnectedServiceName。 string. ConnectedServiceNameSelector = ConnectedServiceName の場合に必要です。
ターゲットの Azure クラシック サブスクリプションを指定します。
azureSubscription - Azure サブスクリプション
入力エイリアス: ConnectedServiceNameARM。 string. ConnectedServiceNameSelector = ConnectedServiceNameARM の場合に必要です。
ターゲットの Azure Resource Manager サブスクリプションを指定します。
Destination - 送信先の種類
string. 必須です。 使用できる値: AzureBlob (Azure Blob)、 AzureVMs (Azure VM)。
ファイルのコピーに使用するコピー先の種類を指定します。
classicStorage - クラシック ストレージ アカウント
入力エイリアス: StorageAccount。 string. ConnectedServiceNameSelector = ConnectedServiceName の場合に必要です。
既存のクラシック ストレージ アカウントを指定します。 これは、Azure VM にファイルをコピーするための仲介役として使用されるストレージ アカウントです。
storage - RM ストレージ アカウント
入力エイリアス: StorageAccountRM。 string. 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 - クラウド サービス
入力エイリアス: EnvironmentName。 string. ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs の場合に必要です。
ターゲット クラウド サービスの名前を指定します。
resourceGroup - リソース グループ
入力エイリアス: EnvironmentNameRM。 string. 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 の使用。