Get-AzStorageFileCopyState
コピー操作の状態を取得します。
構文
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 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。 指定した間隔で前の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。 間隔が経過する前にこのコマンドレットが正常な応答を受け取らない場合、このコマンドレットはエラーを返します。
型: | Nullable<T>[Int32] |
Aliases: | ClientTimeoutPerRequestInSeconds |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ConcurrentTaskCount
同時ネットワーク呼び出しの最大数を指定します。 このパラメーターを使用すると、同時ネットワーク呼び出しの最大数を指定することで、ローカル CPU と帯域幅の使用量を調整するコンカレンシーを制限できます。 指定した値は絶対カウントであり、コア数には乗算されません。 このパラメーターは、1 秒あたり 100 キロビットなどの低帯域幅環境でのネットワーク接続の問題を減らすのに役立ちます。 既定値は 10 です。
型: | Nullable<T>[Int32] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Context
Azure Storage コンテキストを指定します。 コンテキストを取得するには、 New-AzStorageContext コマンドレットを使用します。
型: | IStorageContext |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisAllowTrailingDot
末尾のドット (.) をディレクトリ名とファイル名にサフィックス付けしないようにします。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-File
CloudFile オブジェクトを指定します。 クラウド ファイルを作成することも、Get-AzStorageFile コマンドレットを使用してクラウド ファイルを取得することもできます。
型: | CloudFile |
Aliases: | CloudFile |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-FilePath
Azure Storage 共有に対するファイルの相対パスを指定します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ServerTimeoutPerRequest
要求のサーバー部分のタイムアウト期間の長さを指定します。
型: | Nullable<T>[Int32] |
Aliases: | ServerTimeoutPerRequestInSeconds |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ShareFileClient
ShareFileClient オブジェクトは、コピー状態を取得するファイルを示しました。
型: | ShareFileClient |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ShareName
共有の名前を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WaitForComplete
このコマンドレットがコピーの完了を待機することを示します。 このパラメーターを指定しない場合、このコマンドレットはすぐに結果を返します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |