Get-AzStorageFileContent
Pobiera zawartość pliku.
Składnia
Get-AzStorageFileContent
[-ShareName] <String>
[-Path] <String>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-AsJob]
[-DisAllowTrailingDot]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>] Get-AzStorageFileContent
[-Share] <CloudFileShare>
[-ShareClient <ShareClient>]
[-Path] <String>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>] Get-AzStorageFileContent
[-Directory] <CloudFileDirectory>
[-ShareDirectoryClient <ShareDirectoryClient>]
[-Path] <String>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>] Get-AzStorageFileContent
[-File] <CloudFile>
[-ShareFileClient <ShareFileClient>]
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>] Opis
Polecenie cmdlet Get-AzStorageFileContent pobiera zawartość pliku, a następnie zapisuje go w określonym miejscu docelowym. To polecenie cmdlet nie zwraca zawartości pliku.
Przykłady
Przykład 1. Pobieranie pliku z folderu
Get-AzStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"To polecenie pobiera plik o nazwie CurrentDataFile w folderze ContosoWorkingFolder z udziału plików ContosoShare06 do bieżącego folderu.
Przykład 2. Pobieranie plików w przykładowym udziale plików
Get-AzStorageFile -ShareName sample | Where-Object {$_.GetType().Name -eq "CloudFile"} | Get-AzStorageFileContentW tym przykładzie pliki są pobierane w ramach przykładowego udziału plików
Przykład 3: Pobierz plik platformy Azure do pliku lokalnego i zasłuż na właściwości SMB usługi Azure File (atrybuty plików, czas tworzenia pliku, czas ostatniego zapisu pliku) w pliku lokalnym.
Get-AzStorageFileContent -ShareName sample -Path "dir1/file1" -Destination $localFilePath -PreserveSMBAttributeW tym przykładzie plik platformy Azure jest pobierany do pliku lokalnego i umożliwia właściwości protokołu SMB usługi Azure File (atrybuty plików, czas tworzenia pliku, czas ostatniego zapisu pliku) w pliku lokalnym.
Parametry
-AsJob
Uruchom polecenie cmdlet w tle.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-CheckMd5
Określa, czy sprawdzić sumę Md5 dla pobranego pliku.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-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] |
| Aliasy: | ClientTimeoutPerRequestInSeconds |
| 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 zmniejszeniu 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 |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Context
Określa kontekst usługi Azure Storage. Aby uzyskać kontekst, użyj polecenia cmdlet New-AzStorageContext.
| 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 |
-Destination
Określa ścieżkę docelową. To polecenie cmdlet pobiera zawartość pliku do lokalizacji, która określa ten parametr. Jeśli określisz ścieżkę pliku, który nie istnieje, to polecenie cmdlet utworzy ten plik i zapisze zawartość w nowym pliku. Jeśli określisz ścieżkę pliku, który już istnieje i określisz parametr Force , polecenie cmdlet zastąpi plik. Jeśli określisz ścieżkę istniejącego pliku i nie określisz wartości Force, polecenie cmdlet wyświetli monit przed kontynuowaniem. Jeśli określisz ścieżkę folderu, to polecenie cmdlet podejmie próbę utworzenia pliku, który ma nazwę pliku usługi Azure Storage.
| Typ: | String |
| Position: | 2 |
| 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 zawartość pliku w folderze, który określa ten parametr. Aby uzyskać katalog, użyj polecenia cmdlet New-AzStorageDirectory. Możesz również użyć polecenia cmdlet Get-AzStorageFile, aby uzyskać katalog.
| Typ: | CloudFileDirectory |
| Aliasy: | CloudFileDirectory |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DisAllowTrailingDot
Nie zezwalaj na końcowe kropki (.) na sufiksy katalogów i nazw plików.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-File
Określa plik jako obiekt CloudFile . To polecenie cmdlet pobiera plik, który określa ten parametr. Aby uzyskać obiekt CloudFile , użyj polecenia cmdlet Get-AzStorageFile.
| Typ: | CloudFile |
| Aliasy: | CloudFile |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Force
Jeśli określisz ścieżkę pliku, który nie istnieje, to polecenie cmdlet utworzy ten plik i zapisze zawartość w nowym pliku. Jeśli określisz ścieżkę pliku, który już istnieje i określisz parametr Force , polecenie cmdlet zastąpi plik. Jeśli określisz ścieżkę istniejącego pliku i nie określisz wartości Force, polecenie cmdlet wyświetli monit przed kontynuowaniem. Jeśli określisz ścieżkę folderu, to polecenie cmdlet podejmie próbę utworzenia pliku, który ma nazwę pliku usługi Azure Storage.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PassThru
Wskazuje, że to polecenie cmdlet zwraca obiekt AzureStorageFile , który pobiera.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Path
Właściwość określa ścieżkę pliku. To polecenie cmdlet pobiera zawartość pliku, który określa ten parametr. Jeśli plik nie istnieje, to polecenie cmdlet zwraca błąd.
| Typ: | String |
| Position: | 1 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PreserveSMBAttribute
Zachowaj właściwości SMB pliku źródłowego (atrybuty plików, czas tworzenia pliku, czas ostatniego zapisu pliku) w pliku docelowym. Ten parametr jest dostępny tylko w systemie Windows.
| Typ: | SwitchParameter |
| Position: | Named |
| 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 magazynu zwróci błąd.
| Typ: | Nullable<T>[Int32] |
| Aliasy: | ServerTimeoutPerRequestInSeconds |
| 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 zawartość pliku w udziale, który określa ten parametr. Aby uzyskać obiekt CloudFileShare , użyj polecenia cmdlet Get-AzStorageShare. Ten obiekt zawiera kontekst magazynu. Jeśli określisz ten parametr, nie określ parametru Context .
| Typ: | CloudFileShare |
| Aliasy: | CloudFileShare |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ShareClient
Obiekt CloudFileShare wskazał udział, w którym zostanie pobrany plik.
| Typ: | ShareClient |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ShareDirectoryClient
Obiekt ShareDirectoryClient wskazał katalog w chmurze, w którym zostanie pobrany plik.
| Typ: | ShareDirectoryClient |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ShareFileClient
Obiekt ShareFileClient wskazał, że plik w chmurze ma zostać pobrany.
| Typ: | ShareFileClient |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ShareName
Określa nazwę udziału plików. To polecenie cmdlet pobiera zawartość pliku w udziale, 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 |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |