Get-AzureStorageFile
列出路徑的目錄和檔案。
警告
自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。
語法
Get-AzureStorageFile
[-ShareName] <String>
[[-Path] <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] Get-AzureStorageFile
[-Share] <CloudFileShare>
[[-Path] <String>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] Get-AzureStorageFile
[-Directory] <CloudFileDirectory>
[[-Path] <String>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] Description
Get-AzureStorageFile Cmdlet 會列出您指定之共享或目錄的目錄和檔案。 指定 Path 參數，以取得指定路徑中目錄或檔案的實例。 此 Cmdlet 會傳 回 AzureStorageFile 和 AzureStorageDirectory 物件。 您可以使用 IsDirectory 屬性來區分資料夾和檔案。
範例
範例 1：列出共用中的目錄
PS C:\>Get-AzureStorageFile -ShareName "ContosoShare06" | where {$_.GetType().Name -eq "CloudFileDirectory"}此命令只會列出共用 ContosoShare06 中的目錄。 它會先擷取檔案和目錄、使用管線運算符將它們傳遞給 where 運算符，然後捨棄類型不是 “CloudFileDirectory” 的任何物件。
範例 2：列出檔案目錄
PS C:\> Get-AzureStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzureStorageFile此命令會列出 ContosoShare06 下 ContosoWorkingFolder 目錄中的檔案和資料夾。 它會先取得目錄實例，然後將它管線至 Get-AzureStorageFile Cmdlet 以列出目錄。
參數
-ClientTimeoutPerRequest
指定一個服務要求的用戶端超時時間間隔，以秒為單位。 如果先前的呼叫在指定的間隔內失敗，此 Cmdlet 會重試要求。 如果此 Cmdlet 在間隔經過之前未收到成功的回應，此 Cmdlet 會傳回錯誤。
| 類型: | Nullable<T>[Int32] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ConcurrentTaskCount
指定並行網路呼叫上限。 您可以藉由指定並行網路呼叫數目上限，使用此參數來限制並行 CPU 和頻寬使用量的並行存取。 指定的值是絕對計數，不會乘以核心計數。 此參數可協助降低低頻寬環境中的網路連線問題，例如每秒 100 千位。 預設值為 10。
| 類型: | Nullable<T>[Int32] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Context
指定 Azure 儲存體 內容。 若要取得記憶體內容，請使用 New-AzureStorageContext Cmdlet。
| 類型: | IStorageContext |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-DefaultProfile
用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Directory
將資料夾指定為 CloudFileDirectory 物件。 此 Cmdlet 會取得此參數所指定的資料夾。 若要取得目錄，請使用 New-AzureStorageDirectory Cmdlet。 您也可以使用 Get-AzureStorageFile Cmdlet 來取得目錄。
| 類型: | CloudFileDirectory |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Path
指定資料夾的路徑。 如果您省略 Path 參數， Get-AzureStorageFile 會列出指定檔案共享或目錄中的目錄和檔案。 如果您包含 Path 參數， Get-AzureStorageFile 會傳回指定路徑中目錄或檔案的實例。
| 類型: | String |
| Position: | 1 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ServerTimeoutPerRequest
指定要求的服務端逾時間隔，以秒為單位。 如果指定的間隔在服務處理要求之前經過，記憶體服務會傳回錯誤。
| 類型: | 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 |
輸入
參數：共用（ByValue）
參數：目錄（ByValue）