Get-AzStorageFileContent
Lädt den Inhalt einer Datei herunter.
Syntax
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>]
Beschreibung
Das Cmdlet "Get-AzStorageFileContent " lädt den Inhalt einer Datei herunter und speichert sie dann an einem von Ihnen angegebenen Ziel. Dieses Cmdlet gibt den Inhalt der Datei nicht zurück.
Beispiele
Beispiel 1: Herunterladen einer Datei aus einem Ordner
Get-AzStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"
Mit diesem Befehl wird eine Datei mit dem Namen CurrentDataFile im Ordner "ContosoWorkingFolder" aus der Dateifreigabe "ContosoShare06" in den aktuellen Ordner heruntergeladen.
Beispiel 2: Lädt die Dateien unter der Beispieldateifreigabe herunter.
Get-AzStorageFile -ShareName sample | Where-Object {$_.GetType().Name -eq "CloudFile"} | Get-AzStorageFileContent
In diesem Beispiel werden die Dateien unter der Beispieldateifreigabe heruntergeladen.
Beispiel 3: Laden Sie eine Azure-Datei in eine lokale Datei herunter, und speichern Sie die Azure File SMB-Eigenschaften (File Attributtes, File Creation Time, File Last Write Time) in der lokalen Datei.
Get-AzStorageFileContent -ShareName sample -Path "dir1/file1" -Destination $localFilePath -PreserveSMBAttribute
In diesem Beispiel wird eine Azure-Datei in eine lokale Datei heruntergeladen und die Azure File SMB-Eigenschaften (File Attributtes, File Creation Time, Last Write Time) in der lokalen Datei gespeichert.
Parameter
-AsJob
Führen Sie das Cmdlet im Hintergrund aus.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckMd5
Gibt an, ob die Md5-Summe für die heruntergeladene Datei überprüft werden soll.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClientTimeoutPerRequest
Gibt das clientseitige Timeoutintervall in Sekunden für eine Serviceanfrage an. Wenn der vorherige Aufruf im angegebenen Intervall 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.
Type: | Nullable<T>[Int32] |
Aliases: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 zu reduzieren, z. B. 100 Kilobit pro Sekunde. Der Standardwert ist 10.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
Gibt einen Azure Storage-Kontext an. Verwenden Sie zum Abrufen eines Kontexts das Cmdlet New-AzStorageContext.
Type: | IStorageContext |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Destination
Gibt den Zielpfad an. Dieses Cmdlet lädt den Dateiinhalt an den Speicherort herunter, den dieser Parameter angibt. Wenn Sie den Pfad einer datei angeben, die nicht vorhanden ist, erstellt dieses Cmdlet diese Datei und speichert den Inhalt in der neuen Datei. Wenn Sie einen Pfad einer Datei angeben, die bereits vorhanden ist und Sie den Parameter Force angeben, überschreibt das Cmdlet die Datei. Wenn Sie einen Pfad einer vorhandenen Datei angeben und "Force" nicht angeben, werden Sie vom Cmdlet aufgefordert, bevor sie fortgesetzt wird. Wenn Sie den Pfad eines Ordners angeben, versucht dieses Cmdlet, eine Datei mit dem Namen der Azure-Speicherdatei zu erstellen.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Directory
Gibt einen Ordner als CloudFileDirectory -Objekt an. Dieses Cmdlet ruft Inhalt für eine Datei im Ordner ab, den dieser Parameter angibt. Verwenden Sie zum Abrufen eines Verzeichnisses das Cmdlet New-AzStorageDirectory. Sie können auch das Cmdlet Get-AzStorageFile verwenden, um ein Verzeichnis abzurufen.
Type: | CloudFileDirectory |
Aliases: | CloudFileDirectory |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisAllowTrailingDot
Nicht zulassen, dass nachgestellter Punkt (.) verzeichnis- und Dateinamen suffixiert werden.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-File
Gibt eine Datei als CloudFile-Objekt an. Dieses Cmdlet ruft die Datei ab, die dieser Parameter angibt. Verwenden Sie das Cmdlet Get-AzStorageFile, um ein CloudFile-Objekt abzurufen.
Type: | CloudFile |
Aliases: | CloudFile |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Wenn Sie den Pfad einer datei angeben, die nicht vorhanden ist, erstellt dieses Cmdlet diese Datei und speichert den Inhalt in der neuen Datei. Wenn Sie einen Pfad einer Datei angeben, die bereits vorhanden ist und Sie den Parameter Force angeben, überschreibt das Cmdlet die Datei. Wenn Sie einen Pfad einer vorhandenen Datei angeben und "Force" nicht angeben, werden Sie vom Cmdlet aufgefordert, bevor sie fortgesetzt wird. Wenn Sie den Pfad eines Ordners angeben, versucht dieses Cmdlet, eine Datei mit dem Namen der Azure-Speicherdatei zu erstellen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Gibt an, dass dieses Cmdlet das azureStorageFile -Objekt zurückgibt, das es herunterlädt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Gibt den Pfad einer Datei an. Dieses Cmdlet ruft den Inhalt der Datei ab, die dieser Parameter angibt. Wenn die Datei nicht vorhanden ist, gibt dieses Cmdlet einen Fehler zurück.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreserveSMBAttribute
Behalten Sie die SMB-Eigenschaften der Quelldatei (Datei attributtes, Dateierstellungszeit, Letzte Schreibzeit) in der Zieldatei bei. Dieser Parameter ist nur unter Windows verfügbar.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Nullable<T>[Int32] |
Aliases: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Share
Gibt ein CloudFileShare -Objekt an. Dieses Cmdlet lädt den Inhalt der Datei in der Freigabe herunter, die dieser Parameter angibt. Verwenden Sie das Cmdlet Get-AzStorageShare, um ein CloudFileShare-Objekt abzurufen. Dieses Objekt enthält den Speicherkontext. Wenn Sie diesen Parameter angeben, geben Sie nicht den Context-Parameter an.
Type: | CloudFileShare |
Aliases: | CloudFileShare |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareClient
Das CloudFileShare-Objekt hat die Freigabe angegeben, an der die Datei heruntergeladen wurde.
Type: | ShareClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareDirectoryClient
Das ShareDirectoryClient-Objekt hat das Cloudverzeichnis angegeben, in das die Datei heruntergeladen wurde.
Type: | ShareDirectoryClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareFileClient
Das ShareFileClient-Objekt gibt an, dass die Clouddatei heruntergeladen werden soll.
Type: | ShareFileClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareName
Gibt den Namen der Dateifreigabe an. Dieses Cmdlet lädt den Inhalt der Datei in der Freigabe herunter, die dieser Parameter angibt.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Ausgaben
Ähnliche Themen
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für