Udostępnij za pośrednictwem

Get-AzureStorageFile

  • Odwołanie
Moduł:
Azure.Storage

Wyświetla listę katalogów i plików dla ścieżki.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

Get-AzureStorageFile
   [-ShareName] <String>
   [[-Path] <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzureStorageFile
   [-Share] <CloudFileShare>
   [[-Path] <String>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzureStorageFile
   [-Directory] <CloudFileDirectory>
   [[-Path] <String>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-AzureStorageFile wyświetla katalogi i pliki dla określonego udziału lub katalogu. Określ parametr Ścieżka, aby uzyskać wystąpienie katalogu lub pliku w określonej ścieżce. To polecenie cmdlet zwraca obiekty AzureStorageFile i AzureStorageDirectory . Możesz użyć właściwości IsDirectory , aby odróżnić foldery i pliki.

Przykłady

Przykład 1. Wyświetlanie listy katalogów w udziale

PS C:\>Get-AzureStorageFile -ShareName "ContosoShare06" | where {$_.GetType().Name -eq "CloudFileDirectory"}

To polecenie wyświetla tylko katalogi w udziale ContosoShare06. Najpierw pobiera pliki i katalogi, przekazuje je do operatora where przy użyciu operatora potoku, a następnie odrzuca wszystkie obiekty, których typ nie jest "CloudFileDirectory".

Przykład 2. Wyświetlanie listy katalogów plików

PS C:\> Get-AzureStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzureStorageFile

To polecenie wyświetla listę plików i folderów w katalogu ContosoWorkingFolder w ramach udziału ContosoShare06. Najpierw pobiera wystąpienie katalogu, a następnie potokuje je do polecenia cmdlet Get-AzureStorageFile w celu wyświetlenia listy katalogów.

Parametry

-ClientTimeoutPerRequest

Określa interwał limitu czasu po stronie klienta w sekundach dla jednego żądania obsługi. Jeśli poprzednie wywołanie zakończy się niepowodzeniem w określonym interwale, to polecenie cmdlet ponawia próbę żądania. Jeśli to polecenie cmdlet nie otrzyma pomyślnej odpowiedzi przed upływem interwału, to polecenie cmdlet zwróci błąd.

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ConcurrentTaskCount

Określa maksymalne współbieżne wywołania sieciowe. Tego parametru można użyć, aby ograniczyć współbieżność w celu ograniczenia użycia lokalnego procesora CPU i przepustowości, określając maksymalną liczbę współbieżnych wywołań sieciowych. Określona wartość jest liczbą bezwzględną i nie jest mnożona przez liczbę rdzeni. Ten parametr może pomóc w ograniczeniu problemów z połączeniem sieciowym w środowiskach o niskiej przepustowości, takich jak 100 kilobitów na sekundę. Wartość domyślna to 10.

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Context

Określa kontekst usługi Azure Storage. Aby uzyskać kontekst magazynu, użyj polecenia cmdlet New-AzureStorageContext.

Typ:IStorageContext
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Directory

Określa folder jako obiekt CloudFileDirectory . To polecenie cmdlet pobiera folder, który określa ten parametr. Aby uzyskać katalog, użyj polecenia cmdlet New-AzureStorageDirectory. Aby uzyskać katalog, możesz również użyć polecenia cmdlet Get-AzureStorageFile .

Typ:CloudFileDirectory
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Path

Określa ścieżkę folderu. Jeśli pominięto parametr Path , polecenie Get-AzureStorageFile wyświetla katalogi i pliki w określonym udziale plików lub katalogu. W przypadku uwzględnienia parametru Path polecenie Get-AzureStorageFile zwraca wystąpienie katalogu lub pliku w określonej ścieżce.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ServerTimeoutPerRequest

Określa interwał limitu czasu po stronie usługi w sekundach dla żądania. Jeśli określony interwał upłynie, zanim usługa przetworzy żądanie, usługa Storage zwróci błąd.

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Share

Określa obiekt CloudFileShare . To polecenie cmdlet pobiera plik lub katalog z udziału plików, który określa ten parametr. Aby uzyskać obiekt CloudFileShare , użyj polecenia cmdlet Get-AzureStorageShare. Ten obiekt zawiera kontekst magazynu. Jeśli określisz ten parametr, nie określ parametru Context .

Typ:CloudFileShare
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ShareName

Określa nazwę udziału plików. To polecenie cmdlet pobiera plik lub katalog z udziału plików, który określa ten parametr.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

CloudFileShare

Parametry: Udostępnianie (ByValue)

CloudFileDirectory

Parametry: Katalog (ByValue)

IStorageContext

Dane wyjściowe

CloudFile