Set-AzStorageFileContent

  • Referentie
Module:
Az.Storage

Uploadt de inhoud van een bestand.

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

De cmdlet Set-AzStorageFileContent uploadt de inhoud van een bestand naar een bestand op een opgegeven share.

Voorbeelden

Voorbeeld 1: Een bestand uploaden in de huidige map

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

Met deze opdracht wordt een bestand met de naam DataFile37 in de huidige map geüpload als een bestand met de naam CurrentDataFile in de map ContosoWorkingFolder.

Voorbeeld 2: Alle bestanden in de huidige map uploaden

$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 dit voorbeeld worden verschillende veelgebruikte Windows PowerShell-cmdlets en de huidige cmdlet gebruikt om alle bestanden uit de huidige map te uploaden naar de hoofdmap van container ContosoShare06. Met de eerste opdracht wordt de naam van de huidige map opgehaald en opgeslagen in de $CurrentFolder variabele. De tweede opdracht maakt gebruik van de cmdlet Get-AzStorageShare om de bestandsshare met de naam ContosoShare06 op te halen en slaat deze vervolgens op in de variabele $Container. Met de laatste opdracht wordt de inhoud van de huidige map opgehaald en wordt elke map doorgegeven aan de cmdlet Where-Object met behulp van de pijplijnoperator. Met deze cmdlet worden objecten gefilterd die geen bestanden zijn en worden de bestanden vervolgens doorgegeven aan de cmdlet ForEach-Object. Met deze cmdlet wordt een scriptblok uitgevoerd voor elk bestand dat het juiste pad voor het bestand maakt en vervolgens de huidige cmdlet gebruikt om het bestand te uploaden. Het resultaat heeft dezelfde naam en dezelfde relatieve positie met betrekking tot de andere bestanden die in dit voorbeeld worden geüpload. Typ voor meer informatie over scriptblokken Get-Help about_Script_Blocks.

Voorbeeld 3: Een lokaal bestand uploaden naar een Azure-bestand en de lokale SMB-eigenschappen (bestandsdistributies, tijd voor het maken van bestanden, tijd voor laatste schrijfbewerking) in het Azure-bestand reserveren.

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

In dit voorbeeld wordt een lokaal bestand geüpload naar een Azure-bestand en worden de lokale SMB-eigenschappen (Bestandsdistributies, Tijd voor het maken van bestanden, Tijd voor laatste schrijfbewerking) in het Azure-bestand geplaatst.

Parameters

-AsJob

Voer de cmdlet op de achtergrond uit.

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

-ClientTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de clientzijde op, in seconden, voor één serviceaanvraag. Als de vorige aanroep mislukt in het opgegeven interval, probeert deze cmdlet de aanvraag opnieuw uit te voeren. Als deze cmdlet geen geslaagd antwoord ontvangt voordat het interval is verstreken, retourneert deze cmdlet een fout.

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

-ConcurrentTaskCount

Hiermee geeft u het maximum aantal gelijktijdige netwerkaanroepen op. U kunt deze parameter gebruiken om de gelijktijdigheid te beperken om het lokale CPU- en bandbreedtegebruik te beperken door het maximum aantal gelijktijdige netwerkaanroepen op te geven. De opgegeven waarde is een absoluut aantal en wordt niet vermenigvuldigd met het aantal kernen. Deze parameter kan helpen bij het verminderen van netwerkverbindingsproblemen in omgevingen met lage bandbreedte, zoals 100 kilobits per seconde. De standaardwaarde is 10.

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Context

Hiermee geeft u een Azure-opslagcontext op. Gebruik de cmdlet New-AzStorageContext om een opslagcontext te verkrijgen.

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

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

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

-Directory

Hiermee geeft u een map op als een CloudFileDirectory-object . Met deze cmdlet wordt het bestand geüpload naar de map die met deze parameter wordt opgegeven. Gebruik de cmdlet New-AzStorageDirectory om een map te verkrijgen. U kunt ook de Cmdlet Get-AzStorageFile gebruiken om een map op te halen.

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

-DisAllowTrailingDot

Volg punt (.) niet toe om achtervoegselmap en bestandsnamen te achtervoegsel.

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

-Force

Hiermee wordt aangegeven dat met deze cmdlet een bestaand Azure-opslagbestand wordt overschreven.

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

-PassThru

Geeft aan dat deze cmdlet het AzureStorageFile-object retourneert dat het maakt of uploadt.

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

-Path

Hiermee geeft u het pad van een bestand of map. Met deze cmdlet wordt inhoud geüpload naar het bestand dat met deze parameter wordt opgegeven of naar een bestand in de map die met deze parameter wordt opgegeven. Als u een map opgeeft, maakt deze cmdlet een bestand met dezelfde naam als het bronbestand. Als u een pad opgeeft van een bestand dat niet bestaat, maakt deze cmdlet dat bestand en slaat u de inhoud op in dat bestand. Als u een bestand opgeeft dat al bestaat en u de parameter Force opgeeft, overschrijft deze cmdlet de inhoud van het bestand. Als u een bestand opgeeft dat al bestaat en u geen force opgeeft, wordt met deze cmdlet geen wijzigingen aangebracht en wordt er een fout geretourneerd. Als u een pad opgeeft van een map die niet bestaat, brengt deze cmdlet geen wijzigingen aan en wordt er een fout geretourneerd.

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

-PreserveSMBAttribute

Behoud de SMB-broneigenschappen (bestandsdistributies, tijd voor het maken van bestanden, tijd voor laatste schrijfbewerking) in het doelbestand. Deze parameter is alleen beschikbaar in Windows.

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

-ServerTimeoutPerRequest

Hiermee geeft u de lengte van de time-outperiode voor het serveronderdeel van een aanvraag.

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

-Share

Hiermee geeft u een CloudFileShare-object . Deze cmdlet uploadt naar een bestand in de bestandsshare die met deze parameter wordt opgegeven. Gebruik de cmdlet Get-AzStorageShare om een CloudFileShare-object op te halen. Dit object bevat de opslagcontext. Als u deze parameter opgeeft, geeft u de contextparameter niet op.

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

-ShareClient

ShareClient-object geeft de share aan waarnaar het bestand zou worden geüpload.

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

-ShareDirectoryClient

Het CloudFileDirectory-object heeft de cloudmap aangegeven waar het bestand zou worden geüpload.

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

-ShareName

Hiermee geeft u de naam van de bestandsshare. Deze cmdlet uploadt naar een bestand in de bestandsshare die met deze parameter wordt opgegeven.

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

-Source

Hiermee geeft u het bronbestand op dat door deze cmdlet wordt geüpload. Als u een bestand opgeeft dat niet bestaat, retourneert deze cmdlet een fout.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

CloudFileShare

CloudFileDirectory

String

IStorageContext

Uitvoerwaarden

AzureStorageFile