Get-AzStorageFileContent
構文
ShareName (既定)
Get-AzStorageFileContent
[-ShareName] <String>
[-Path] <String>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-AsJob]
[-DisAllowTrailingDot]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>]
Share
Get-AzStorageFileContent
[-ShareClient] <ShareClient>
[-Path] <String>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>]
Directory
Get-AzStorageFileContent
[-ShareDirectoryClient] <ShareDirectoryClient>
[-Path] <String>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>]
File
Get-AzStorageFileContent
[-ShareFileClient] <ShareFileClient>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>]
説明
Get-AzStorageFileContent コマンドレットは、ファイルの内容をダウンロードし、指定した宛先に保存します。
このコマンドレットは、ファイルの内容を返しません。
例
例 1: フォルダーからファイルをダウンロードする
Get-AzStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"
このコマンドは、ContosoWorkingFolder フォルダー内の CurrentDataFile という名前のファイルを、ファイル共有 ContosoShare06 から現在のフォルダーにダウンロードします。
例 2: サンプル ファイル共有のファイルをダウンロードする
Get-AzStorageFile -ShareName sample | Where-Object {$_.GetType().Name -eq "AzureStorageFile"} | Get-AzStorageFileContent
この例では、サンプル ファイル共有の下にファイルをダウンロードします
例 3: ローカル ファイルに Azure ファイルをダウンロードし、ローカル ファイルの Azure ファイル SMB プロパティ (ファイル属性、ファイル作成時刻、ファイル最終書き込み時刻) を保持します。
Get-AzStorageFileContent -ShareName sample -Path "dir1/file1" -Destination $localFilePath -PreserveSMBAttribute
この例では、ローカル ファイルに Azure ファイルをダウンロードし、ローカル ファイルの Azure ファイル SMB プロパティ (ファイル属性、ファイル作成時刻、ファイルの最終書き込み時刻) を保持します。
パラメーター
-AsJob
バックグラウンドでコマンドレットを実行します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-CheckMd5
ダウンロードしたファイルの Md5 合計を確認するかどうかを指定します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ClientTimeoutPerRequest
1 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。 指定した間隔で前の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。 間隔が経過する前にこのコマンドレットが正常な応答を受け取らない場合、このコマンドレットはエラーを返します。
パラメーターのプロパティ
型: | Nullable<T>[Int32]
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ClientTimeoutPerRequestInSeconds |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ConcurrentTaskCount
同時ネットワーク呼び出しの最大数を指定します。 このパラメーターを使用すると、同時ネットワーク呼び出しの最大数を指定することで、ローカル CPU と帯域幅の使用量を調整するコンカレンシーを制限できます。 指定した値は絶対カウントであり、コア数には乗算されません。 このパラメーターは、1 秒あたり 100 キロビットなどの低帯域幅環境でのネットワーク接続の問題を減らすのに役立ちます。 既定値は 10 です。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Context
Azure Storage コンテキストを指定します。 コンテキストを取得するには、New-AzStorageContext コマンドレットを使用します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Destination
宛先パスを指定します。
このコマンドレットは、このパラメーターが指定した場所にファイルの内容をダウンロードします。
存在しないファイルのパスを指定した場合、このコマンドレットはそのファイルを作成し、その内容を新しいファイルに保存します。
既に存在するファイルのパスを指定し、Force パラメーターを指定すると、コマンドレットによってファイルが上書きされます。
既存のファイルのパスを指定し、Forceを指定しない場合は、続行する前にメッセージが表示されます。
フォルダーのパスを指定すると、このコマンドレットは Azure ストレージ ファイルの名前を持つファイルの作成を試みます。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | 2 |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DisAllowTrailingDot
末尾のドット (.) をディレクトリ名とファイル名にサフィックス付けしないようにします。
パラメーターのプロパティ
パラメーター セット
ShareName
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Force
存在しないファイルのパスを指定した場合、このコマンドレットはそのファイルを作成し、その内容を新しいファイルに保存します。
既に存在するファイルのパスを指定し、Force パラメーターを指定すると、コマンドレットによってファイルが上書きされます。
既存のファイルのパスを指定し、Forceを指定しない場合は、続行する前にメッセージが表示されます。
フォルダーのパスを指定すると、このコマンドレットは Azure ストレージ ファイルの名前を持つファイルの作成を試みます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-PassThru
このコマンドレットは、ダウンロードした azureStorageFile オブジェクト を返します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Path
ファイルのパスを指定します。
このコマンドレットは、このパラメーターが指定するファイルの内容を取得します。
ファイルが存在しない場合、このコマンドレットはエラーを返します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
ShareName
配置: | 1 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
Share
配置: | 1 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
Directory
配置: | 1 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-PreserveSMBAttribute
コピー元のファイル SMB プロパティ (ファイル属性、ファイル作成時刻、ファイルの最終書き込み時刻) をコピー先ファイルに保持します。 このパラメーターは Windows でのみ使用できます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ServerTimeoutPerRequest
要求のサービス側のタイムアウト間隔を秒単位で指定します。 サービスが要求を処理する前に指定した間隔が経過すると、ストレージ サービスはエラーを返します。
パラメーターのプロパティ
型: | Nullable<T>[Int32]
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ServerTimeoutPerRequestInSeconds |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ShareClient
ShareClient オブジェクトは、ファイルがダウンロードされる共有を示しました。
パラメーターのプロパティ
型: | ShareClient
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
Share
配置: | 0 |
必須: | True |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-ShareDirectoryClient
ShareDirectoryClient オブジェクトは、ファイルがダウンロードされるクラウド ディレクトリを示しました。
パラメーターのプロパティ
パラメーター セット
Directory
配置: | 0 |
必須: | True |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-ShareFileClient
ShareFileClient オブジェクトは、ダウンロードするクラウド ファイルを示しました。
パラメーターのプロパティ
パラメーター セット
File
配置: | 0 |
必須: | True |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-ShareName
ファイル共有の名前を指定します。
このコマンドレットは、このパラメーターが指定する共有内のファイルの内容をダウンロードします。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
ShareName
配置: | 0 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
型: | SwitchParameter
|
規定値: | False |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ウィスコンシン |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力