PowerShell BitsTransfer

PowerShell BitsTransfer †

#enull{{ &tag(PowerShell,BITS,BitsTransfer,Background Intelligent Transfer Service,バックグラウンドインテリジェント転送サービス); }}

PowerShellにてBITS(バックグラウンドインテリジェント転送サービス:Background Intelligent Transfer Service)を扱えるようにする †

PS> Import-Module -Name BitsTransfer

コマンドレット一覧 †

Get-Command -Module BitsTransfer | Select-Object -Property Name

追加 †

削除 †

取得 †

BITSジョブを取得する †

• 現在のユーザの、BITSジョブを全て取得する

  Get-BitsTransfer

• 現在のユーザの、ジョブIDが00000000-0000-0000-000000000000であるジョブを取得する

  Get-BitsTransfer -JobId 00000000-0000-0000-000000000000

• 現在のユーザの、ジョブ名がTestJobであるBITSジョブを取得する

  Get-BitsTransfer -Name TestJob

• 現在のユーザの、ジョブ名がTestで始まるBITSジョブを全て取得する

  Get-BitsTransfer -Name Test*

• 現在のユーザの、ジョブ名がTestで始まる、もしくはJobで終わるBITSジョブを全て取得する

  Get-BitsTransfer -Name Test*, *Job

• 現在のユーザの、ジョブ名がTestで始まり1桁の連番で終わるBITSジョブを全て取得する

  Get-BitsTransfer -Name Test*[0-9]

• 全てのユーザの、BITSジョブを全て取得する

  Get-BitsTransfer -AllUsers

• 全てのユーザの、ジョブ名がTestで始まるBITSジョブを全て取得する

  Get-BitsTransfer -AllUsers -Name Test*

• 現在のユーザの、ジョブ名がTestJobであるBITSジョブの、転送種別(ダウンロード,アップロード)を取得する

  (Get-BitsTransfer -Name TestJob).TransferType

• 現在のユーザの、ジョブ名がTestJobであるBITSジョブの、状態を取得する

  (Get-BitsTransfer -Name TestJob).JobState

• 現在のユーザの、ジョブ名がTestJobであるBITSジョブの、優先度を取得する

  (Get-BitsTransfer -Name TestJob).Priority

• 現在のユーザの、ジョブ名がTestJobであるBITSジョブの、転送に利用するプロキシ設定を取得する

  (Get-BitsTransfer -Name TestJob).ProxyUsage

• 現在のユーザの、ジョブ名がTestJobであるBITSジョブの、エラー発生状況を取得する

  (Get-BitsTransfer -Name TestJob).ErrorCondition

• 現在のユーザの、ジョブ名がTestJobであるBITSジョブの、総転送量(バイト)を取得する

  (Get-BitsTransfer -Name TestJob).BytesTotal

• 現在のユーザの、ジョブ名がTestJobであるBITSジョブの、現在までの転送量(バイト)を取得する

  (Get-BitsTransfer -Name TestJob).BytesTransferred

• 現在のユーザの、ジョブ名がTestJobであるBITSジョブの、総ファイル数を取得する

  (Get-BitsTransfer -Name TestJob).FilesTotal

• 現在のユーザの、ジョブ名がTestJobであるBITSジョブの、転送完了したファイル数を取得する

  (Get-BitsTransfer -Name TestJob).FilesTransferred

• 現在のユーザの、ジョブ名がTestJobであるBITSジョブの、転送ファイル一覧(リモート)を取得する

  (Get-BitsTransfer -Name TestJob).FileList | ForEach-Object {$_.RemoteName}

• 現在のユーザの、ジョブ名がTestJobであるBITSジョブの、転送ファイル一覧(ローカル)を取得する

  (Get-BitsTransfer -Name TestJob).FileList | ForEach-Object {$_.LocalName}

• 現在のユーザの、ジョブ名がTestJobであるBITSジョブの、転送ファイル完了数を取得する

  ((Get-BitsTransfer -Name TestJob).FileList | Where-Object {$_.IsTransferComplete} | Measure-Object).Count

設定 †

開始 †

一時停止 †

再開 †

完了 †

BITSジョブを完了させる †

• ジョブ名がTestJobであるBITSジョブを完了させる

  $job = Get-BitsTransfer -Name TestJob
  Complete-BitsTransfer -BitsJob $job

• ジョブ名がTestJobであるBITSジョブを完了させる

  Get-BitsTransfer -Name TestJob | Complete-BitsTransfer