Dela via


Get-AzStorageFile

Visar kataloger och filer för en sökväg.

Syntax

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

Cmdleten Get-AzStorageFile visar kataloger och filer för den resurs eller katalog som du anger. Ange parametern Sökväg för att hämta en instans av en katalog eller fil i den angivna sökvägen. Den här cmdleten returnerar AzureStorageFile - och AzureStorageDirectory-objekt . Du kan använda egenskapen IsDirectory för att skilja mellan mappar och filer.

Exempel

Exempel 1: Lista kataloger i en resurs

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

Det här kommandot visar endast katalogerna i resursen ContosoShare06. Den hämtar först både filer och kataloger, skickar dem till operatorn där med hjälp av pipelineoperatorn och tar sedan bort alla objekt vars typ inte är "AzureStorageFileDirectory".

Exempel 2: Lista en filkatalog

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

Det här kommandot visar filerna och mapparna i katalogen ContosoWorkingFolder under resursen ContosoShare06. Den hämtar först kataloginstansen och dirigerar den sedan till cmdleten Get-AzStorageFile för att visa katalogen.

Parametrar

-ClientTimeoutPerRequest

Anger tidsgränsen på klientsidan, i sekunder, för en tjänstbegäran. Om det föregående anropet misslyckas inom det angivna intervallet försöker denna cmdlet skicka begäran igen. Om den här cmdleten inte får något lyckat svar innan intervallet förflutit returnerar den här cmdleten ett fel.

Typ:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ConcurrentTaskCount

Anger maximalt antal samtidiga nätverksanrop. Du kan använda den här parametern för att begränsa samtidigheten för att begränsa den lokala processor- och bandbreddsanvändningen genom att ange det maximala antalet samtidiga nätverksanrop. Det angivna värdet är ett absolut antal och multipliceras inte med kärnantalet. Den här parametern kan bidra till att minska problem med nätverksanslutningar i miljöer med låg bandbredd, till exempel 100 kilobit per sekund. Standardvärdet är 10.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Context

Anger en Azure Storage-kontext. Om du vill hämta en Storage-kontext använder du cmdleten New-AzStorageContext.

Typ:IStorageContext
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Directory

Anger en mapp som ett CloudFileDirectory-objekt . Den här cmdleten hämtar mappen som den här parametern anger. Om du vill hämta en katalog använder du cmdleten New-AzStorageDirectory. Du kan också använda cmdleten Get-AzStorageFile för att hämta en katalog.

Typ:CloudFileDirectory
Alias:CloudFileDirectory
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DisAllowTrailingDot

Tillåt inte avslutande punkt (.) till suffixkatalog och filnamn.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ExcludeExtendedInfo

Inkludera inte utökad filinformation som tidsstämplar, ETag, attribut, permissionKey i listfil och katalog.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger sökvägen till en mapp. Om du utelämnar sökvägsparametern visar Get-AzStorageFile katalogerna och filerna i den angivna filresursen eller katalogen. Om du inkluderar parametern Sökväg returnerar Get-AzStorageFile en instans av en katalog eller fil i den angivna sökvägen.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServerTimeoutPerRequest

Anger tidsgränsintervallet på tjänstsidan, i sekunder, för en begäran. Om det angivna intervallet förflutit innan tjänsten bearbetar begäran returnerar Lagringstjänsten ett fel.

Typ:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Share

Anger ett CloudFileShare-objekt . Den här cmdleten hämtar en fil eller katalog från den filresurs som den här parametern anger. Om du vill hämta ett CloudFileShare-objekt använder du cmdleten Get-AzStorageShare. Det här objektet innehåller lagringskontexten. Om du anger den här parametern ska du inte ange parametern Kontext .

Typ:CloudFileShare
Alias:CloudFileShare
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ShareClient

ShareClient-objektet angav resursen där filerna/katalogerna skulle visas.

Typ:ShareClient
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ShareDirectoryClient

ShareDirectoryClient-objektet angav den basmapp där filerna/katalogerna skulle visas.

Typ:ShareDirectoryClient
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ShareName

Anger namnet på filresursen. Den här cmdleten hämtar en fil eller katalog från den filresurs som den här parametern anger.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

CloudFileShare

CloudFileDirectory

IStorageContext

Utdata

AzureStorageFile