Freigeben über

Get-AzStorageFile

Modul:
Az.Storage Module

Listet Verzeichnisse und Dateien für einen Pfad auf.

Syntax

ShareName (Standard) 

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

Share 

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

Directory 

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

Beschreibung

Das Cmdlet "Get-AzStorageFile " 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 mithilfe des Pipelineoperators an den Where-Operator 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. Zunächst wird die Verzeichnisinstanz abgerufen und dann an das Cmdlet "Get-AzStorageFile " weitergeleitet, um das Verzeichnis aufzulisten.

Beispiel 3: Auflisten von Dateien und Verzeichnissen in einer Freigabe und Ausschließen erweiterter Informationen

Get-AzStorageFile -ShareName "ContosoShare06" -ExcludeExtendedInfo

Dieser Befehl listet die Dateien und Ordner in der ContosoShare06-Freigabe auf und schließt erweiterte Dateiinformationen wie Zeitstempel, ETag, Attribute, PermissionKey in Listendatei und Verzeichnis aus. Derzeit wird -ExcludeExtendedInfo benötigt, um Dateien und Verzeichnisse aus der NFS-Dateifreigabe oder aus einem Verzeichnis in der NFS-Dateifreigabe auflisten zu können.

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.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ClientTimeoutPerRequestInSeconds

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Context

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

Parametereigenschaften

Typ:IStorageContext
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisAllowTrailingDot

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ShareName
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ExcludeExtendedInfo

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Path

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ServerTimeoutPerRequestInSeconds

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ShareClient

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

Parametereigenschaften

Typ:ShareClient
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Share
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ShareDirectoryClient

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

Parametereigenschaften

Typ:ShareDirectoryClient
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Directory
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ShareName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ShareName
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

ShareClient

ShareDirectoryClient

IStorageContext

Ausgaben

AzureStorageFile