Get-AzStorageBlobCopyState

  • リファレンス
モジュール:
Az.Storage

Azure Storage BLOB のコピーの状態を取得します。

構文

Get-AzStorageBlobCopyState
   [-Blob] <String>
   [-Container] <String>
   [-WaitForComplete]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageBlobCopyState
   -CloudBlob <CloudBlob>
   [-WaitForComplete]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageBlobCopyState
   -CloudBlobContainer <CloudBlobContainer>
   [-Blob] <String>
   [-WaitForComplete]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

説明

Get-AzStorageBlobCopyState コマンドレットは、Azure Storage BLOB のコピー状態を取得します。 コピー先 BLOB で実行する必要があります。

例

例 1: BLOB のコピー状態を取得する

Get-AzStorageBlobCopyState -Blob "ContosoPlanning2015" -Container "ContosoUploads"

このコマンドは、コンテナー ContosoUploads 内の ContosoPlanning2015 という名前の BLOB のコピー状態を取得します。

例 2: パイプラインを使用して BLOB のコピー状態を取得する

Get-AzStorageBlob -Blob "ContosoPlanning2015" -Container "ContosoUploads" | Get-AzStorageBlobCopyState

このコマンドは、Get-AzStorageBlob コマンドレットを使用して ContosoUploads という名前のコンテナー内の ContosoPlanning2015 という名前の BLOB を取得し、パイプライン演算子を使用して現在のコマンドレットに結果を渡します。 Get-AzStorageBlobCopyState コマンドレットは、その BLOB のコピー状態を取得します。

例 3: パイプラインを使用してコンテナー内の BLOB のコピー状態を取得する

Get-AzStorageContainer -Name "ContosoUploads" | Get-AzStorageBlobCopyState -Blob "ContosoPlanning2015"

このコマンドは、Get-AzStorageBlob コマンドレットを使用して名前付きのコンテナーを取得し、結果を現在のコマンドレットに渡します。 Get-AzStorageContainer コマンドレットは、そのコンテナー内の ContosoPlanning2015 という名前の BLOB のコピー状態を取得します。

例 4: コピーを開始し、パイプラインを実行してコピーの状態を取得する

$destBlob = Start-AzStorageBlobCopy -SrcContainer "contosouploads" -SrcBlob "ContosoPlanning2015" -DestContainer "contosouploads2" -DestBlob "ContosoPlanning2015_copy"

$destBlob | Get-AzStorageBlobCopyState

最初のコマンドは、BLOB "ContosoPlanning2015" を "ContosoPlanning2015_copy" にコピーし、destiantion BLOB オブジェクトを出力します。 2 番目のコマンドは、BLOB コピーの状態を取得するために、Get-AzStorageBlobCopyState に destiantion BLOB オブジェクトをパイプライン化します。

パラメーター

-Blob

BLOB の名前を指定します。 このコマンドレットは、このパラメーターが指定する Azure Storage BLOB の BLOB コピー操作の状態を取得します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ClientTimeoutPerRequest

1 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。 指定した間隔で前の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。 間隔が経過する前にこのコマンドレットが正常な応答を受け取らない場合、このコマンドレットはエラーを返します。

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CloudBlob

Azure Storage クライアント ライブラリの CloudBlob オブジェクトを指定します。 CloudBlob オブジェクトを取得するには、Get-AzStorageBlob コマンドレットを使用します。

Type:CloudBlob
Aliases:ICloudBlob
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CloudBlobContainer

Azure Storage クライアント ライブラリの CloudBlobContainer オブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するコンテナー内の BLOB のコピー状態を取得します。 CloudBlobContainer オブジェクトを取得するには、Get-AzStorageContainer コマンドレットを使用します。

Type:CloudBlobContainer
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ConcurrentTaskCount

同時ネットワーク呼び出しの最大数を指定します。 このパラメーターを使用すると、同時ネットワーク呼び出しの最大数を指定することで、ローカル CPU と帯域幅の使用量を調整するコンカレンシーを制限できます。 指定した値は絶対カウントであり、コア数には乗算されません。 このパラメーターは、1 秒あたり 100 キロビットなどの低帯域幅環境でのネットワーク接続の問題を減らすのに役立ちます。 既定値は 10 です。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

コンテナーの名前を指定します。 このコマンドレットは、このパラメーターが指定するコンテナー内の BLOB のコピー状態を取得します。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Context

Azure ストレージ コンテキストを指定します。 ストレージ コンテキストを取得するには、New-AzStorageContext コマンドレットを使用します。

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

要求のサービス側のタイムアウト間隔を秒単位で指定します。 サービスが要求を処理する前に指定した間隔が経過すると、ストレージ サービスはエラーを返します。

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WaitForComplete

このコマンドレットがコピーの完了を待機することを示します。 このパラメーターを指定しない場合、このコマンドレットはすぐに結果を返します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

CloudBlob

CloudBlobContainer

IStorageContext

出力

CopyState