共用方式為


Get-AzStorageFile

列出路徑的目錄和檔案。

語法

Get-AzStorageFile
   [-ShareName] <String>
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageFile
   [-Share] <CloudFileShare>
   [-ShareClient <ShareClient>]
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageFile
   [-Directory] <CloudFileDirectory>
   [-ShareDirectoryClient <ShareDirectoryClient>]
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

Get-AzStorageFile Cmdlet 會列出您指定之共享或目錄的目錄和檔案。 指定 Path 參數,以取得指定路徑中目錄或檔案的實例。 此 Cmdlet 會傳 回 AzureStorageFileAzureStorageDirectory 物件。 您可以使用 IsDirectory 屬性來區分資料夾和檔案。

範例

範例 1:列出共用中的目錄

Get-AzStorageFile -ShareName "ContosoShare06" | Where-Object {$_.GetType().Name -eq "AzureStorageFileDirectory"}

此命令只會列出共用 ContosoShare06 中的目錄。 它會先擷取檔案和目錄、使用管線運算符將它們傳遞給 where 運算符,然後捨棄類型不是 “AzureStorageFileDirectory” 的任何物件。

範例 2:列出檔案目錄

Get-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzStorageFile

此命令會列出 ContosoShare06 下 ContosoWorkingFolder 目錄中的檔案和資料夾。 它會先取得目錄實例,然後將它管線至 Get-AzStorageFile Cmdlet 以列出目錄。

參數

-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

-Context

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

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

-DefaultProfile

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

類型:IAzureContextContainer
別名:AzureRmContext, AzureCredential
Position:Named
預設值: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

-ExcludeExtendedInfo

不包含擴充的檔案資訊,例如時間戳、ETag、屬性、list 檔案和 Directory 中的 permissionKey。

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

-Path

指定資料夾的路徑。 如果您省略 Path 參數, Get-AzStorageFile 會列出指定檔案共享或目錄中的目錄和檔案。 如果您包含 Path 參數, Get-AzStorageFile 會傳回指定路徑中目錄或檔案的實例。

類型:String
Position:1
預設值: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

ShareClient 物件指出要列出檔案/目錄的共用。

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

-ShareDirectoryClient

ShareDirectoryClient 物件指出要列出檔案/目錄的基底資料夾。

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

-ShareName

指定檔案共享的名稱。 這個 Cmdlet 會從此參數指定的檔案共用取得檔案或目錄。

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

輸入

CloudFileShare

CloudFileDirectory

IStorageContext

輸出

AzureStorageFile