Get-AzStorageFileCopyState

リファレンス

モジュール:: Az.Storage

コピー操作の状態を取得します。

構文

Get-AzStorageFileCopyState
   [-ShareName] <String>
   [-FilePath] <String>
   [-WaitForComplete]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Get-AzStorageFileCopyState
   [-File] <CloudFile>
   [-ShareFileClient <ShareFileClient>]
   [-WaitForComplete]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

説明

Get-AzStorageFileCopyState コマンドレットは、Azure Storage ファイルのコピー操作の状態を取得します。コピー先ファイルで実行する必要があります。

例

例 1: ファイル名でコピー状態を取得する

Get-AzStorageFileCopyState -ShareName "ContosoShare" -FilePath "ContosoFile"

このコマンドは、指定された名前を持つファイルのコピー操作の状態を取得します。

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

$destfile = Start-AzStorageFileCopy -SrcShareName "contososhare" -SrcFilePath "contosofile" -DestShareName "contososhare2" -destfilepath "contosofile_copy"  

$destfile | Get-AzStorageFileCopyState

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

パラメーター

-ClientTimeoutPerRequest

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

Type:	Nullable<T>[Int32]
Aliases:	ClientTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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

-Context

Azure Storage コンテキストを指定します。コンテキストを取得するには、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

-DisAllowTrailingDot

末尾のドット (.) をディレクトリ名とファイル名にサフィックス付けしないようにします。

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

-File

CloudFile オブジェクトを指定します。クラウドファイルを作成することも、Get-AzStorageFile コマンドレットを使用してクラウドファイルを取得することもできます。

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

-FilePath

Azure Storage 共有に対するファイルの相対パスを指定します。

Type:	String
Position:	1
Default value:	None
Required:	True
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

-ShareFileClient

ShareFileClient オブジェクトは、コピー状態を取得するファイルを示しました。

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

-ShareName

共有の名前を指定します。

Type:	String
Position:	0
Default value:	None
Required:	True
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

入力

CloudFile

IStorageContext

出力

CopyState