共用方式為


Get-AzStorageFileContent

下載檔案的內容。

語法

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>]
Get-AzStorageFileContent
   [-Share] <CloudFileShare>
   [-ShareClient <ShareClient>]
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Get-AzStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-ShareDirectoryClient <ShareDirectoryClient>]
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Get-AzStorageFileContent
   [-File] <CloudFile>
   [-ShareFileClient <ShareFileClient>]
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Description

Get-AzStorageFileContent Cmdlet 會下載檔案的內容,然後將它儲存至您指定的目的地。 此 Cmdlet 不會傳回檔案的內容。

範例

範例 1:從資料夾下載檔案

Get-AzStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"

此命令會將 ContosoWorkingFolder 資料夾中名為 CurrentDataFile 的檔案從檔案共用 ContosoShare06 下載到目前資料夾。

範例 2:下載範例檔案共用下的檔案

Get-AzStorageFile -ShareName sample | Where-Object {$_.GetType().Name -eq "CloudFile"} | Get-AzStorageFileContent

此範例會下載範例檔案共用下的檔案

範例 3:將 Azure 檔案下載到本機檔案,並在本機檔案中保留 Azure 檔案 SMB 屬性(檔案屬性、檔案建立時間、檔案上次寫入時間)。

Get-AzStorageFileContent -ShareName sample -Path "dir1/file1" -Destination $localFilePath -PreserveSMBAttribute

此範例會將 Azure 檔案下載到本機檔案,並在本機檔案中保留 Azure 檔案 SMB 屬性(檔案屬性、檔案建立時間、檔案上次寫入時間)。

參數

-AsJob

在背景中執行 Cmdlet。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CheckMd5

指定是否要檢查所下載檔案的 Md5 總和。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ClientTimeoutPerRequest

指定一個服務要求的用戶端超時時間間隔,以秒為單位。 如果先前的呼叫在指定的間隔內失敗,此 Cmdlet 會重試要求。 如果此 Cmdlet 在間隔經過之前未收到成功的回應,此 Cmdlet 會傳回錯誤。

類型:Nullable<T>[Int32]
別名:ClientTimeoutPerRequestInSeconds
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ConcurrentTaskCount

指定並行網路呼叫上限。 您可以藉由指定並行網路呼叫數目上限,使用此參數來限制並行 CPU 和頻寬使用量的並行存取。 指定的值是絕對計數,不會乘以核心計數。 此參數可協助減少低頻寬環境中的網路連線問題,例如每秒 100 千位。 預設值為 10。

類型:Nullable<T>[Int32]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Context

指定 Azure 儲存體 內容。 若要取得內容,請使用 New-AzStorageContext Cmdlet。

類型:IStorageContext
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Destination

指定目的地路徑。 此 Cmdlet 會將檔案內容下載到此參數指定的位置。 如果您指定不存在的檔案路徑,此 Cmdlet 會建立該檔案,並將內容儲存在新檔案中。 如果您指定已經存在的檔案路徑,而且指定 Force 參數,Cmdlet 會覆寫檔案。 如果您指定現有檔案的路徑,但未指定 Force,Cmdlet 會在繼續之前提示您。 如果您指定資料夾的路徑,此 Cmdlet 會嘗試建立具有 Azure 記憶體檔案名稱的檔案。

類型:String
Position:2
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Directory

將資料夾指定為 CloudFileDirectory 物件。 這個 Cmdlet 會取得此參數所指定資料夾中檔案的內容。 若要取得目錄,請使用 New-AzStorageDirectory Cmdlet。 您也可以使用 Get-AzStorageFile Cmdlet 來取得目錄。

類型:CloudFileDirectory
別名:CloudFileDirectory
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-DisAllowTrailingDot

不允許尾端點 (.) 後置詞目錄和檔名。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-File

將檔案指定為 CloudFile 物件。 這個 Cmdlet 會取得此參數所指定的檔案。 若要取得 CloudFile 物件,請使用 Get-AzStorageFile Cmdlet。

類型:CloudFile
別名:CloudFile
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Force

如果您指定不存在的檔案路徑,此 Cmdlet 會建立該檔案,並將內容儲存在新檔案中。 如果您指定已經存在的檔案路徑,而且指定 Force 參數,Cmdlet 會覆寫檔案。 如果您指定現有檔案的路徑,但未指定 Force,Cmdlet 會在繼續之前提示您。 如果您指定資料夾的路徑,此 Cmdlet 會嘗試建立具有 Azure 記憶體檔案名稱的檔案。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PassThru

指出此 Cmdlet 會傳回其下載的 AzureStorageFile 物件。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Path

指定檔案的路徑。 此 Cmdlet 會取得此參數所指定檔案的內容。 如果檔案不存在,此 Cmdlet 會傳回錯誤。

類型:String
Position:1
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-PreserveSMBAttribute

將來源檔案 SMB 屬性 (檔案屬性、檔案建立時間、檔案上次寫入時間)保留在目的地檔案中。 此參數僅適用於 Windows。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ServerTimeoutPerRequest

指定要求的服務端超時時間間隔,以秒為單位。 如果指定的間隔在服務處理要求之前經過,則記憶體服務會傳回錯誤。

類型:Nullable<T>[Int32]
別名:ServerTimeoutPerRequestInSeconds
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Share

指定 CloudFileShare 物件。 此 Cmdlet 會下載這個參數所指定共用檔案的內容。 若要取得 CloudFileShare 物件,請使用 Get-AzStorageShare Cmdlet。 這個物件包含記憶體內容。 如果您指定此參數,請勿指定 Context 參數。

類型:CloudFileShare
別名:CloudFileShare
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ShareClient

CloudFileShare 物件指出要下載檔案的共用。

類型:ShareClient
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ShareDirectoryClient

ShareDirectoryClient 物件指出要下載檔案的雲端目錄。

類型:ShareDirectoryClient
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ShareFileClient

ShareFileClient 物件指出要下載的雲端檔案。

類型:ShareFileClient
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ShareName

指定檔案共享的名稱。 此 Cmdlet 會下載這個參數所指定共用檔案的內容。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

輸出

AzureStorageFile