Freigeben über

Get-AzureStorageFileContent

  • Referenz
Modul:
Azure.Storage

Lädt den Inhalt einer Datei herunter.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Get-AzureStorageFileContent
   [-ShareName] <String>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-Share] <CloudFileShare>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-File] <CloudFile>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-AzureStorageFileContent lädt den Inhalt einer Datei herunter und speichert sie dann in einem von Ihnen angegebenen Ziel. Dieses Cmdlet gibt den Inhalt der Datei nicht zurück.

Beispiele

Beispiel 1: Herunterladen einer Datei aus einem Ordner

PS C:\>Get-AzureStorageFileContent -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: Herunterladen der Dateien unter beispieldateifreigabe

PS C:\>Get-AzureStorageFile -ShareName sample | ? {$_.GetType().Name -eq "CloudFile"} | Get-AzureStorageFileContent

In diesem Beispiel werden die Dateien unter der Beispieldateifreigabe heruntergeladen.

Parameter

-CheckMd5

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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientTimeoutPerRequest

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.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

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.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliases:cf
Position:Named
Standardwert:False
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

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.

Typ:IStorageContext
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich: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.

Typ:String
Position:2
Standardwert:None
Erforderlich: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-AzureStorageDirectory. Sie können auch das Cmdlet Get-AzureStorageFile verwenden, um ein Verzeichnis abzurufen.

Typ:CloudFileDirectory
Position:0
Standardwert:None
Erforderlich:True
Accept pipeline input:True
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-AzureStorageFile, um ein CloudFile-Objekt abzurufen.

Typ:CloudFile
Position:0
Standardwert:None
Erforderlich: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich: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.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

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.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich: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-AzureStorageShare, um ein CloudFileShare-Objekt abzurufen. Dieses Objekt enthält den Speicherkontext. Wenn Sie diesen Parameter angeben, geben Sie nicht den Context-Parameter an.

Typ:CloudFileShare
Position:0
Standardwert:None
Erforderlich:True
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.

Typ:String
Position:0
Standardwert:None
Erforderlich: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.

Typ:SwitchParameter
Aliases:wi
Position:Named
Standardwert:False
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

CloudFileShare

Parameter: Share (ByValue)

CloudFileDirectory

Parameter: Directory (ByValue)

CloudFile

Parameter: Datei (ByValue)

IStorageContext

Ausgaben

CloudFile