Freigeben über

Get-AzStorageFile

  • Referenz
Modul:
Az.Storage

Listet Verzeichnisse und Dateien für einen Pfad auf.

Syntax

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

Beschreibung

Die Get-AzStorageFile- Cmdlet listet Verzeichnisse und Dateien für die von Ihnen angegebene Freigabe oder das angegebene Verzeichnis auf. Geben Sie den Path Parameter an, um eine Instanz eines Verzeichnisses oder einer Datei im angegebenen Pfad abzurufen. Dieses Cmdlet gibt AzureStorageFile- und AzureStorageDirectory--Objekte zurück. Sie können die IsDirectory-Eigenschaft verwenden, um zwischen Ordnern und Dateien zu unterscheiden.

Beispiele

Beispiel 1: Auflisten von Verzeichnissen in einer Freigabe

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

Dieser Befehl listet nur die Verzeichnisse in der ContosoShare06-Freigabe auf. Sie ruft zuerst Dateien und Verzeichnisse ab, übergibt sie an die , wobei Operator mithilfe des Pipelineoperators entfernt werden, und verwirft dann alle Objekte, deren Typ nicht "AzureStorageFileDirectory" ist.

Beispiel 2: Auflisten eines Dateiverzeichnisses

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

Dieser Befehl listet die Dateien und Ordner im Verzeichnis ContosoWorkingFolder unter der Freigabe contosoShare06 auf. Zuerst wird die Verzeichnisinstanz abgerufen und dann an das Get-AzStorageFile Cmdlet weitergeleitet, um das Verzeichnis aufzulisten.

Parameter

-ClientTimeoutPerRequest

Gibt das clientseitige Timeoutintervall in Sekunden für eine Serviceanfrage an. Wenn der vorherige Aufruf innerhalb des angegebenen Intervalls fehlschlägt, führt dieses Cmdlet die Anforderung erneut aus. Wenn dieses Cmdlet vor Ablauf des Intervalls keine erfolgreiche Antwort erhält, gibt dieses Cmdlet einen Fehler zurück.

Typ:Nullable<T>[Int32]
Aliase:ClientTimeoutPerRequestInSeconds
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConcurrentTaskCount

Gibt die maximalen gleichzeitigen Netzwerkanrufe an. Mit diesem Parameter können Sie die Parallelität einschränken, um die lokale CPU- und Bandbreitenauslastung zu drosseln, indem Sie die maximale Anzahl gleichzeitiger Netzwerkanrufe angeben. Der angegebene Wert ist eine absolute Anzahl und wird nicht mit der Kernanzahl multipliziert. Dieser Parameter kann dazu beitragen, Netzwerkverbindungsprobleme in Umgebungen mit geringer Bandbreite wie 100 Kilobit pro Sekunde zu mindern. Der Standardwert ist 10.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Context

Gibt einen Azure Storage-Kontext an. Verwenden Sie zum Abrufen eines Speicherkontexts das cmdlet New-AzStorageContext.

Typ:IStorageContext
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisAllowTrailingDot

Nicht zulassen, dass nachgestellter Punkt (.) verzeichnis- und Dateinamen suffixiert werden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExcludeExtendedInfo

Fügen Sie keine erweiterten Dateiinformationen wie Zeitstempel, ETag, Attribute, PermissionKey in Listendatei und Verzeichnis hinzu.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Pfad eines Ordners an. Wenn Sie den parameter Path weglassen, werden Get-AzStorageFile- die Verzeichnisse und Dateien in der angegebenen Dateifreigabe oder im angegebenen Verzeichnis aufgelistet. Wenn Sie den parameter Path einschließen, gibt Get-AzStorageFile eine Instanz eines Verzeichnisses oder einer Datei im angegebenen Pfad zurück.

Typ:String
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServerTimeoutPerRequest

Gibt das dienstseitige Timeoutintervall in Sekunden für eine Anforderung an. Wenn das angegebene Intervall verstrichen ist, bevor der Dienst die Anforderung verarbeitet, gibt der Speicherdienst einen Fehler zurück.

Typ:Nullable<T>[Int32]
Aliase:ServerTimeoutPerRequestInSeconds
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ShareClient

Das ShareClient-Objekt hat die Freigabe angegeben, in der die Dateien/Verzeichnisse aufgelistet werden.

Typ:ShareClient
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ShareDirectoryClient

Das ShareDirectoryClient-Objekt hat den Basisordner angegeben, in dem die Dateien/Verzeichnisse aufgelistet werden.

Typ:ShareDirectoryClient
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ShareName

Gibt den Namen der Dateifreigabe an. Dieses Cmdlet ruft eine Datei oder ein Verzeichnis aus der Dateifreigabe ab, die dieser Parameter angibt.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Ausgaben