Set-AzStorageFileContent

  • Reference
Modul:
Az.Storage

Nahraje obsah souboru.

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>]

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 -Share $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 pomocí rutiny Get-AzStorageShare získá sdílenou složku 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 je 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í.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

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

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Directory

Určuje složku jako objekt CloudFileDirectory . Tato rutina nahraje soubor do složky, kterou tento parametr určuje. K získání adresáře použijte rutinu New-AzStorageDirectory. K získání adresáře můžete použít také rutinu Get-AzStorageFile.

Type:CloudFileDirectory
Aliases:CloudFileDirectory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DisAllowTrailingDot

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

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

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Share

Určuje objekt CloudFileShare . Tato rutina se nahraje do souboru ve sdílené složce, který určuje tento parametr. K získání objektu CloudFileShare použijte rutinu Get-AzStorageShare. Tento objekt obsahuje kontext úložiště. Pokud zadáte tento parametr, nezadávejte parametr Context .

Type:CloudFileShare
Aliases:CloudFileShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareClient

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

Type:ShareClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareDirectoryClient

CloudFileDirectory objekt indikoval cloudový adresář, do kterého se soubor nahrál.

Type:ShareDirectoryClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Source

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

Type:String
Aliases:FullName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

CloudFileShare

CloudFileDirectory

String

IStorageContext

Výstupy

AzureStorageFile