Freigeben über

Set-AzStorageFileContent

Modul:
Az.Storage Module

Lädt den Inhalt einer Datei hoch.

Syntax

ShareName (Standard) 

Set-AzStorageFileContent
    [-ShareName] <String>
    [-Source] <String>
    [[-Path] <String>]
    [-FileMode <String>]
    [-Owner <String>]
    [-Group <String>]
    [-PassThru]
    [-Force]
    [-AsJob]
    [-DisAllowTrailingDot]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [-PreserveSMBAttribute]
    [<CommonParameters>]

Share 

Set-AzStorageFileContent
    [-ShareClient] <ShareClient>
    [-Source] <String>
    [[-Path] <String>]
    [-FileMode <String>]
    [-Owner <String>]
    [-Group <String>]
    [-PassThru]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [-PreserveSMBAttribute]
    [<CommonParameters>]

Directory 

Set-AzStorageFileContent
    [-ShareDirectoryClient] <ShareDirectoryClient>
    [-Source] <String>
    [[-Path] <String>]
    [-FileMode <String>]
    [-Owner <String>]
    [-Group <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 -ShareClient $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 jeden mithilfe des Pipelineoperators an das cmdlet Where-Object. 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: Hochladen einer lokalen Datei in eine Azure-Datei und Beibehalten der lokalen Datei-SMB-Eigenschaften (Dateiattribute, Dateierstellungszeit, Zeitpunkt der letzten Dateischreibzeit) 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 (Dateiattribute, Dateierstellungszeit, Letzte Schreibzeit) in der Azure-Datei beibehalten.

Beispiel 4: Hochladen einer Datei mit FileMode, Besitzer und Gruppe in eine NFS-Dateifreigabe

Set-AzStorageFileContent -ShareName "contososhare06" -Source "DataFile37" -Path "ContosoWorkingFolder/CurrentDataFile" -FileMode rw-r--rwt -Owner 1 -Group 1

Mit diesem Befehl wird eine lokale Datei in eine Azure-Datei mit FileMode rwxrwSrwx, Owner 1 und Group 1 hochgeladen. FileMode, Owner, Group funktioniert nur auf NFS-Dateifreigabe.

Parameter

-AsJob

Führen Sie das Cmdlet im Hintergrund aus.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ClientTimeoutPerRequestInSeconds

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Context

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

Parametereigenschaften

Typ:IStorageContext
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisAllowTrailingDot

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ShareName
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FileMode

Gilt nur für NFS-Dateien. Die Modusberechtigungen, die für die Datei festgelegt werden sollen. Symbolisch (rwxrw-rw-) wird unterstützt.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Group

Gilt nur für NFS-Dateien. Der Besitzergruppenbezeichner (GID), der für die Datei festgelegt werden soll. Der Standardwert ist 0 (Stammgruppe).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Owner

Gilt nur für NFS-Dateien. Der Benutzerbezeichner (UID) des Besitzers, der für die Datei festgelegt werden soll. Der Standardwert ist 0 (Stamm).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PassThru

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PreserveSMBAttribute

Behalten Sie die SMB-Eigenschaften der Quelldatei (Dateiattribute, Dateierstellungszeit, Letzte Schreibzeit) in der Zieldatei bei. Dieser Parameter ist nur unter Windows verfügbar.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ServerTimeoutPerRequest

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

Parametereigenschaften

Typ:

Nullable<T>[Int32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ServerTimeoutPerRequestInSeconds

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ShareClient

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

Parametereigenschaften

Typ:ShareClient
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Share
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ShareDirectoryClient

Das ShareDirectoryClient-Objekt hat das Verzeichnis angegeben, in das die Datei hochgeladen werden würde.

Parametereigenschaften

Typ:ShareDirectoryClient
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Directory
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ShareName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ShareName
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:FullName

Parametersätze

(All)
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

ShareClient

ShareDirectoryClient

String

IStorageContext

Ausgaben

AzureStorageFile