Get-AzureStorageFileContent

ファイルの内容をダウンロードします。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

Get-AzureStorageFileContent
   [-ShareName] <String>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-Share] <CloudFileShare>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-File] <CloudFile>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Get-AzureStorageFileContent コマンドレットは、ファイルの内容をダウンロードし、指定した宛先に保存します。 このコマンドレットは、ファイルの内容を返しません。

例 1: フォルダーからファイルをダウンロードする

PS C:\>Get-AzureStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"

このコマンドは、ContosoWorkingFolder フォルダー内の CurrentDataFile という名前のファイルを、ファイル共有 ContosoShare06 から現在のフォルダーにダウンロードします。

例 2: サンプル ファイル共有のファイルをダウンロードする

PS C:\>Get-AzureStorageFile -ShareName sample | ? {$_.GetType().Name -eq "CloudFile"} | Get-AzureStorageFileContent

この例では、サンプル ファイル共有の下にファイルをダウンロードします

パラメーター

-CheckMd5

存在しないファイルのパスを指定した場合、このコマンドレットはそのファイルを作成し、その内容を新しいファイルに保存します。 既に存在するファイルのパスを指定し、Force パラメーターを指定すると、コマンドレットによってファイルが上書きされます。 既存のファイルのパスを指定し、Force を指定しない場合は、続行する前にプロンプトが表示されます。 フォルダーのパスを指定すると、このコマンドレットは Azure ストレージ ファイルの名前を持つファイルの作成を試みます。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ClientTimeoutPerRequest

存在しないファイルのパスを指定した場合、このコマンドレットはそのファイルを作成し、その内容を新しいファイルに保存します。 既に存在するファイルのパスを指定し、Force パラメーターを指定すると、コマンドレットによってファイルが上書きされます。 既存のファイルのパスを指定し、Force を指定しない場合は、続行する前にプロンプトが表示されます。 フォルダーのパスを指定すると、このコマンドレットは Azure ストレージ ファイルの名前を持つファイルの作成を試みます。

型:Nullable<T>[Int32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ConcurrentTaskCount

存在しないファイルのパスを指定した場合、このコマンドレットはそのファイルを作成し、その内容を新しいファイルに保存します。 既に存在するファイルのパスを指定し、Force パラメーターを指定すると、コマンドレットによってファイルが上書きされます。 既存のファイルのパスを指定し、Force を指定しない場合は、続行する前にプロンプトが表示されます。 フォルダーのパスを指定すると、このコマンドレットは Azure ストレージ ファイルの名前を持つファイルの作成を試みます。

型:Nullable<T>[Int32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Context

存在しないファイルのパスを指定した場合、このコマンドレットはそのファイルを作成し、その内容を新しいファイルに保存します。 既に存在するファイルのパスを指定し、Force パラメーターを指定すると、コマンドレットによってファイルが上書きされます。 既存のファイルのパスを指定し、Force を指定しない場合は、続行する前にプロンプトが表示されます。 フォルダーのパスを指定すると、このコマンドレットは Azure ストレージ ファイルの名前を持つファイルの作成を試みます。

型:IStorageContext
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Destination

宛先パスを指定します。 このコマンドレットは、このパラメーターが指定した場所にファイルの内容をダウンロードします。 存在しないファイルのパスを指定した場合、このコマンドレットはそのファイルを作成し、その内容を新しいファイルに保存します。 既に存在するファイルのパスを指定し、Force パラメーターを指定すると、コマンドレットによってファイルが上書きされます。 既存のファイルのパスを指定し、Force を指定しない場合は、続行する前にプロンプトが表示されます。 フォルダーのパスを指定すると、このコマンドレットは Azure ストレージ ファイルの名前を持つファイルの作成を試みます。

型:String
配置:2
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Directory

フォルダーを CloudFileDirectory オブジェクトとして指定します。 このコマンドレットは、このパラメーターが指定するフォルダー内のファイルのコンテンツを取得します。 ディレクトリを取得するには、New-AzureStorageDirectory コマンドレットを使用します。 Get-AzureStorageFile コマンドレットを使用してディレクトリを取得することもできます。

型:CloudFileDirectory
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-File

ファイルを CloudFile オブジェクトとして指定します。 このコマンドレットは、このパラメーターが指定するファイルを取得します。 CloudFile オブジェクトを取得するには、Get-AzureStorageFile コマンドレットを使用します。

型:CloudFile
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Force

存在しないファイルのパスを指定した場合、このコマンドレットはそのファイルを作成し、その内容を新しいファイルに保存します。 既に存在するファイルのパスを指定し、Force パラメーターを指定すると、コマンドレットによってファイルが上書きされます。 既存のファイルのパスを指定し、Force を指定しない場合は、続行する前にプロンプトが表示されます。 フォルダーのパスを指定すると、このコマンドレットは Azure ストレージ ファイルの名前を持つファイルの作成を試みます。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

存在しないファイルのパスを指定した場合、このコマンドレットはそのファイルを作成し、その内容を新しいファイルに保存します。 既に存在するファイルのパスを指定し、Force パラメーターを指定すると、コマンドレットによってファイルが上書きされます。 既存のファイルのパスを指定し、Force を指定しない場合は、続行する前にプロンプトが表示されます。 フォルダーのパスを指定すると、このコマンドレットは Azure ストレージ ファイルの名前を持つファイルの作成を試みます。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Path

ファイルのパスを指定します。 このコマンドレットは、このパラメーターが指定するファイルの内容を取得します。 ファイルが存在しない場合、このコマンドレットはエラーを返します。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServerTimeoutPerRequest

存在しないファイルのパスを指定した場合、このコマンドレットはそのファイルを作成し、その内容を新しいファイルに保存します。 既に存在するファイルのパスを指定し、Force パラメーターを指定すると、コマンドレットによってファイルが上書きされます。 既存のファイルのパスを指定し、Force を指定しない場合は、続行する前にプロンプトが表示されます。 フォルダーのパスを指定すると、このコマンドレットは Azure ストレージ ファイルの名前を持つファイルの作成を試みます。

型:Nullable<T>[Int32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Share

CloudFileShare オブジェクトを指定します。 このコマンドレットは、このパラメーターが指定する共有内のファイルの内容をダウンロードします。 CloudFileShare オブジェクトを取得するには、Get-AzureStorageShare コマンドレットを使用します。 このオブジェクトには、ストレージ コンテキストが含まれています。 このパラメーターを指定する場合は、Context パラメーターを指定しないでください。

型:CloudFileShare
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ShareName

ファイル共有の名前を指定します。 このコマンドレットは、このパラメーターが指定する共有内のファイルの内容をダウンロードします。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

CloudFileShare

パラメーター: 共有 (ByValue)

CloudFileDirectory

パラメーター: ディレクトリ (ByValue)

CloudFile

パラメーター: File (ByValue)

IStorageContext

出力

CloudFile