Dela via

Set-AzStorageFileContent

  • Referens
Modul:
Az.Storage

Laddar upp innehållet i en fil.

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

Cmdleten Set-AzStorageFileContent laddar upp innehållet i en fil till en fil på en angiven resurs.

Exempel

Exempel 1: Ladda upp en fil i den aktuella mappen

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

Det här kommandot laddar upp en fil med namnet DataFile37 i den aktuella mappen som en fil med namnet CurrentDataFile i mappen ContosoWorkingFolder.

Exempel 2: Ladda upp alla filer i den aktuella mappen

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

I det här exemplet används flera vanliga Windows PowerShell-cmdletar och den aktuella cmdleten för att ladda upp alla filer från den aktuella mappen till rotmappen för containern ContosoShare06. Det första kommandot hämtar namnet på den aktuella mappen och lagrar den i variabeln $CurrentFolder. Det andra kommandot använder cmdleten Get-AzStorageShare för att hämta filresursen ContosoShare06 och lagrar den sedan i variabeln $Container. Det sista kommandot hämtar innehållet i den aktuella mappen och skickar var och en till cmdleten Where-Object med hjälp av pipelineoperatorn. Cmdleten filtrerar bort objekt som inte är filer och skickar sedan filerna till cmdleten ForEach-Object. Den cmdleten kör ett skriptblock för varje fil som skapar lämplig sökväg för den och använder sedan den aktuella cmdleten för att ladda upp filen. Resultatet har samma namn och samma relativa position när det gäller de andra filer som det här exemplet laddar upp. Om du vill ha mer information om skriptblock skriver du Get-Help about_Script_Blocks.

Exempel 3: Ladda upp en lokal fil till en Azure-fil och använd de lokala fil-SMB-egenskaperna (fil-attribut, filskapandetid, fil senaste skrivtid) i Azure-filen.

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

I det här exemplet laddas en lokal fil upp till en Azure-fil och de lokala fil-SMB-egenskaperna (fil-attribut, filgenereringstid, fil senast skrivtid) används i Azure-filen.

Parametrar

-AsJob

Kör cmdleten i bakgrunden.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ClientTimeoutPerRequest

Anger tidsgränsen på klientsidan i sekunder för en tjänstbegäran. Om det föregående anropet misslyckas i det angivna intervallet försöker den här cmdleten skicka begäran igen. Om den här cmdleten inte får något lyckat svar innan intervallet förflutit returnerar den här cmdleten ett fel.

Typ:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ConcurrentTaskCount

Anger maximalt antal samtidiga nätverksanrop. Du kan använda den här parametern för att begränsa samtidigheten för att begränsa den lokala processor- och bandbreddsanvändningen genom att ange det maximala antalet samtidiga nätverksanrop. Det angivna värdet är ett absolut antal och multipliceras inte med kärnantalet. Den här parametern kan bidra till att minska problem med nätverksanslutningar i miljöer med låg bandbredd, till exempel 100 kilobit per sekund. Standardvärdet är 10.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Context

Anger en Azure Storage-kontext. Om du vill hämta en lagringskontext använder du cmdleten New-AzStorageContext .

Typ:IStorageContext
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Directory

Anger en mapp som ett CloudFileDirectory-objekt . Den här cmdleten laddar upp filen till den mapp som den här parametern anger. Om du vill hämta en katalog använder du cmdleten New-AzStorageDirectory. Du kan också använda cmdleten Get-AzStorageFile för att hämta en katalog.

Typ:CloudFileDirectory
Alias:CloudFileDirectory
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DisAllowTrailingDot

Tillåt inte avslutande punkt (.) till suffixkatalog och filnamn.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Anger att den här cmdleten skriver över en befintlig Azure-lagringsfil.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PassThru

Anger att den här cmdleten returnerar det AzureStorageFile-objekt som det skapar eller laddar upp.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger sökvägen till en fil eller mapp. Den här cmdleten laddar upp innehåll till filen som den här parametern anger, eller till en fil i mappen som den här parametern anger. Om du anger en mapp skapar den här cmdleten en fil med samma namn som källfilen. Om du anger en sökväg för en fil som inte finns skapar den här cmdleten filen och sparar innehållet i filen. Om du anger en fil som redan finns och du anger force-parametern skriver den här cmdleten över innehållet i filen. Om du anger en fil som redan finns och du inte anger Force gör den här cmdleten ingen ändring och returnerar ett fel. Om du anger en sökväg för en mapp som inte finns gör den här cmdleten ingen ändring och returnerar ett fel.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PreserveSMBAttribute

Behåll SMB-källegenskaperna för filen (fil-attribut, tid för att skapa filer, senaste skrivningstid) i målfilen. Den här parametern är endast tillgänglig i Windows.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServerTimeoutPerRequest

Anger längden på tidsgränsen för serverdelen av en begäran.

Typ:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Share

Anger ett CloudFileShare-objekt . Den här cmdleten laddar upp till en fil i den filresurs som den här parametern anger. Om du vill hämta ett CloudFileShare-objekt använder du cmdleten Get-AzStorageShare. Det här objektet innehåller lagringskontexten. Om du anger den här parametern ska du inte ange parametern Kontext .

Typ:CloudFileShare
Alias:CloudFileShare
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ShareClient

ShareClient-objektet angav resursen där filen skulle laddas upp till.

Typ:ShareClient
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ShareDirectoryClient

CloudFileDirectory-objektet angav den molnkatalog där filen skulle laddas upp.

Typ:ShareDirectoryClient
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ShareName

Anger namnet på filresursen. Den här cmdleten laddar upp till en fil i den filresurs som den här parametern anger.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Source

Anger källfilen som den här cmdleten laddar upp. Om du anger en fil som inte finns returnerar den här cmdleten ett fel.

Typ:String
Alias:FullName
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

CloudFileShare

CloudFileDirectory

String

IStorageContext

Utdata

AzureStorageFile