Sdílet prostřednictvím

Set-AzStorageFileContent

  • Reference
Modul:
Az.Storage

Nahraje obsah souboru.

Syntaxe

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
   [-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
   [-ShareDirectoryClient] <ShareDirectoryClient>
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Description

Rutina Set-AzStorageFileContent nahraje obsah souboru do souboru v zadané sdílené složce.

Příklady

Příklad 1: Nahrání souboru do aktuální složky

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

Tento příkaz nahraje soubor s názvem DataFile37 v aktuální složce jako soubor s názvem CurrentDataFile ve složce s názvem ContosoWorkingFolder.

Příklad 2: Nahrání všech souborů v aktuální složce

$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
}

Tento příklad používá několik běžných rutin Prostředí Windows PowerShell a aktuální rutinu k nahrání všech souborů z aktuální složky do kořenové složky kontejneru ContosoShare06. První příkaz získá název aktuální složky a uloží ho do proměnné $CurrentFolder. Druhý příkaz použije rutinu Get-AzStorageShare k získání sdílené složky s názvem ContosoShare06 a pak ji uloží do proměnné $Container. Poslední příkaz získá obsah aktuální složky a každý z nich předá rutině Where-Object pomocí operátoru kanálu. Tato rutina vyfiltruje objekty, které nejsou soubory, a pak soubory předá rutině ForEach-Object. Tato rutina spustí blok skriptu pro každý soubor, který pro něj vytvoří odpovídající cestu, a pak použije aktuální rutinu k nahrání souboru. Výsledek má stejný název a stejnou relativní pozici s ohledem na ostatní soubory, které tento příklad nahraje. Další informace o blocích skriptu zadejte Get-Help about_Script_Blocks.

Příklad 3: Nahrajte místní soubor do souboru Azure a zarezervujte místní vlastnosti SMB souboru (File Attributtes, File Creation Time, File Last Write Time) v souboru Azure.

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

Tento příklad nahraje místní soubor do souboru Azure a zarezervuje místní vlastnosti SMB souboru (File Attributtes, File Creation Time, File Last Write Time) v souboru Azure.

Parametry

-AsJob

Spusťte rutinu na pozadí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ClientTimeoutPerRequest

Určuje interval časového limitu na straně klienta v sekundách pro jednu žádost o službu. Pokud předchozí volání v zadaném intervalu selže, tato rutina požadavek opakuje. Pokud tato rutina neobdrží úspěšnou odpověď před uplynutím intervalu, vrátí tato rutina chybu.

Typ:Nullable<T>[Int32]
Aliasy:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ConcurrentTaskCount

Určuje maximální počet souběžných síťových volání. Pomocí tohoto parametru můžete omezit souběžnost na omezení využití místního procesoru a šířky pásma zadáním maximálního počtu souběžných síťových volání. Zadaná hodnota je absolutní počet a nevynásobí se počtem jader. Tento parametr může pomoct snížit problémy s připojením k síti v prostředích s nízkou šířkou pásma, například 100 kilobitů za sekundu. Výchozí hodnota je 10.

Typ:Nullable<T>[Int32]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Context

Určuje kontext úložiště Azure. K získání kontextu úložiště použijte rutinu New-AzStorageContext.

Typ:IStorageContext
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisAllowTrailingDot

Zakázat koncové tečky (.) přípony adresáře a názvů souborů

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Označuje, že tato rutina přepíše existující soubor úložiště Azure.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

Označuje, že tato rutina vrátí objekt AzureStorageFile, který vytvoří nebo nahraje.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Path

Určuje cestu k souboru nebo složce. Tato rutina nahraje obsah do souboru, který tento parametr určuje, nebo do souboru ve složce, kterou tento parametr určuje. Pokud zadáte složku, tato rutina vytvoří soubor se stejným názvem jako zdrojový soubor. Pokud zadáte cestu k souboru, který neexistuje, tato rutina tento soubor vytvoří a uloží obsah do tohoto souboru. Pokud zadáte soubor, který již existuje, a zadáte parametr Force, tato rutina přepíše obsah souboru. Pokud zadáte soubor, který již existuje a nezadáte Force, tato rutina neprovádí žádnou změnu a vrátí chybu. Pokud zadáte cestu ke složce, která neexistuje, tato rutina neprovede žádnou změnu a vrátí chybu.

Typ:String
Position:2
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PreserveSMBAttribute

Ponechte vlastnosti SMB zdrojového souboru (File Attributtes, File Creation Time, File Last Write Time) v cílovém souboru. Tento parametr je k dispozici pouze ve Windows.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServerTimeoutPerRequest

Určuje délku časového limitu pro část požadavku serveru.

Typ:Nullable<T>[Int32]
Aliasy:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ShareClient

Objekt ShareClient označil sdílenou složku, do které se soubor nahrál.

Typ:ShareClient
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ShareDirectoryClient

Objekt ShareDirectoryClient označil adresář, do kterého se soubor nahrál.

Typ:ShareDirectoryClient
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ShareName

Určuje název sdílené složky. Tato rutina se nahraje do souboru ve sdílené složce, který určuje tento parametr.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Source

Určuje zdrojový soubor, který tato rutina nahraje. Pokud zadáte soubor, který neexistuje, vrátí tato rutina chybu.

Typ:String
Aliasy:FullName
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

ShareClient

ShareDirectoryClient

String

IStorageContext

Výstupy

AzureStorageFile