Freigeben über


Set-AzStorageFileContent

Lädt den Inhalt einer Datei hoch.

Syntax

Set-AzStorageFileContent
   [-ShareName] <String>
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Set-AzStorageFileContent
   [-Share] <CloudFileShare>
   [-ShareClient <ShareClient>]
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Set-AzStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-ShareDirectoryClient <ShareDirectoryClient>]
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzStorageFileContent lädt den Inhalt einer Datei in eine Datei auf eine angegebene Freigabe hoch.

Beispiele

Beispiel 1: Hochladen einer Datei im aktuellen Ordner

Set-AzStorageFileContent -ShareName "ContosoShare06" -Source "DataFile37" -Path "ContosoWorkingFolder/CurrentDataFile"

Mit diesem Befehl wird eine Datei mit dem Namen DataFile37 im aktuellen Ordner als Datei hochgeladen, die "CurrentDataFile" im Ordner "ContosoWorkingFolder" heißt.

Beispiel 2: Hochladen aller Dateien im aktuellen Ordner

$CurrentFolder = (Get-Item .).FullName
$Container = Get-AzStorageShare -Name "ContosoShare06"
Get-ChildItem -Recurse | Where-Object { $_.GetType().Name -eq "FileInfo"} | ForEach-Object {
    $path=$_.FullName.Substring($Currentfolder.Length+1).Replace("\","/")
    Set-AzStorageFileContent -Share $Container -Source $_.FullName -Path $path -Force
}

In diesem Beispiel werden mehrere gängige Windows PowerShell-Cmdlets und das aktuelle Cmdlet verwendet, um alle Dateien aus dem aktuellen Ordner in den Stammordner des Containers ContosoShare06 hochzuladen. Der erste Befehl ruft den Namen des aktuellen Ordners ab und speichert ihn in der variablen $CurrentFolder. Der zweite Befehl verwendet das Cmdlet "Get-AzStorageShare ", um die Dateifreigabe mit dem Namen ContosoShare06 abzurufen, und speichert sie dann in der variablen $Container. Der letzte Befehl ruft den Inhalt des aktuellen Ordners ab und übergibt jedes Objekt mithilfe des Pipelineoperators an das Where-Object-Cmdlet. Dieses Cmdlet filtert Objekte aus, die keine Dateien sind, und übergibt die Dateien dann an das Cmdlet ForEach-Object. Dieses Cmdlet führt einen Skriptblock für jede Datei aus, die den entsprechenden Pfad dafür erstellt, und verwendet dann das aktuelle Cmdlet, um die Datei hochzuladen. Das Ergebnis hat denselben Namen und dieselbe relative Position in Bezug auf die anderen Dateien, die in diesem Beispiel hochgeladen werden. Weitere Informationen zu Skriptblöcken, geben Sie Get-Help about_Script_Blocksein.

Beispiel 3: Laden Sie eine lokale Datei in eine Azure-Datei hoch, und reservieren Sie die lokalen Datei-SMB-Eigenschaften (File Attributtes, File Creation Time, Datei last Write Time) in der Azure-Datei.

Set-AzStorageFileContent -Source $localFilePath -ShareName sample -Path "dir1/file1" -PreserveSMBAttribute

In diesem Beispiel wird eine lokale Datei in eine Azure-Datei hochgeladen und die lokalen Datei-SMB-Eigenschaften (File Attributtes, File Creation Time, Last Write Time) in der Azure-Datei gespeichert.

Parameter

-AsJob

Führen Sie das Cmdlet im Hintergrund aus.

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

Typ:Nullable<T>[Int32]
Aliase:ClientTimeoutPerRequestInSeconds
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Context

Gibt einen Azure-Speicherkontext an. Verwenden Sie zum Abrufen eines Speicherkontexts das Cmdlet New-AzStorageContext .

Typ:IStorageContext
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Directory

Gibt einen Ordner als CloudFileDirectory -Objekt an. Dieses Cmdlet lädt die Datei in den Ordner hoch, 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.

Typ:CloudFileDirectory
Aliase:CloudFileDirectory
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DisAllowTrailingDot

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Gibt an, dass dieses Cmdlet eine vorhandene Azure-Speicherdatei überschreibt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt an, dass dieses Cmdlet das AzureStorageFile-Objekt zurückgibt, das es erstellt oder hochlädt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Pfad einer Datei oder eines Ordners an. Dieses Cmdlet lädt Inhalte in die Datei hoch, die dieser Parameter angibt, oder in eine Datei im Ordner, den dieser Parameter angibt. Wenn Sie einen Ordner angeben, erstellt dieses Cmdlet eine Datei mit demselben Namen wie die Quelldatei. Wenn Sie einen Pfad einer Datei angeben, die nicht vorhanden ist, erstellt dieses Cmdlet diese Datei und speichert den Inhalt in dieser Datei. Wenn Sie eine Datei angeben, die bereits vorhanden ist, und Sie den Parameter Force angeben, überschreibt dieses Cmdlet den Inhalt der Datei. Wenn Sie eine Datei angeben, die bereits vorhanden ist und Sie keine Force angeben, nimmt dieses Cmdlet keine Änderung vor und gibt einen Fehler zurück. Wenn Sie einen Pfad eines ordners angeben, der nicht vorhanden ist, nimmt dieses Cmdlet keine Änderung vor und gibt einen Fehler zurück.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServerTimeoutPerRequest

Gibt die Länge des Timeoutzeitraums für den Serverteil einer Anforderung an.

Typ:Nullable<T>[Int32]
Aliase:ServerTimeoutPerRequestInSeconds
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Share

Gibt ein CloudFileShare -Objekt an. Dieses Cmdlet lädt in eine Datei in der Dateifreigabe hoch, 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.

Typ:CloudFileShare
Aliase:CloudFileShare
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ShareClient

Das ShareClient-Objekt hat die Freigabe angegeben, in die die Datei hochgeladen werden würde.

Typ:ShareClient
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ShareDirectoryClient

Das CloudFileDirectory-Objekt hat das Cloudverzeichnis angegeben, in das die Datei hochgeladen wurde.

Typ:ShareDirectoryClient
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ShareName

Gibt den Namen der Dateifreigabe an. Dieses Cmdlet lädt in eine Datei in der Dateifreigabe hoch, die dieser Parameter angibt.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Source

Gibt die Quelldatei an, die dieses Cmdlet hochlädt. Wenn Sie eine Datei angeben, die nicht vorhanden ist, gibt dieses Cmdlet einen Fehler zurück.

Typ:String
Aliase:FullName
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

CloudFileShare

CloudFileDirectory

String

IStorageContext

Ausgaben

AzureStorageFile