Share via

Get-AzStorageFile

  • Referens
Modul:
Az.Storage

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.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

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

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:CloudFileDirectory
Aliases:CloudFileDirectory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DisAllowTrailingDot

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeExtendedInfo

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Anger sökvägen till en mapp. Om du utelämnar sökvägsparameternvisar 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.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:CloudFileShare
Aliases:CloudFileShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareClient

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

Type:ShareClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareDirectoryClient

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

Type:ShareDirectoryClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Indata

CloudFileShare

CloudFileDirectory

IStorageContext

Utdata

AzureStorageFile