Get-AzureStorageFileContent

模組:

Azure.Storage

下載檔案的內容。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 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>]

Description

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

範例

範例 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

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

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

-ClientTimeoutPerRequest

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

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

-ConcurrentTaskCount

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

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

-Confirm

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

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

-Context

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

類型:	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-AzureStorageDirectory Cmdlet。 您也可以使用 Get-AzureStorageFile Cmdlet 來取得目錄。

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

-File

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

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

-Force

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

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

-PassThru

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

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

-Path

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

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

-ServerTimeoutPerRequest

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

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

-Share

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

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

-ShareName

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

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

-WhatIf

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

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

輸入

CloudFileShare

參數：共用（ByValue）

CloudFileDirectory

參數：目錄（ByValue）

CloudFile

參數：檔案（ByValue）

IStorageContext

輸出

CloudFile

相關連結

• Get-AzureStorageFile
• Set-AzureStorageFileContent