Set-AzStorageFileContent

Modul:

Az.Storage Module

Nahraje obsah souboru.

Syntax

ShareName (Výchozí)

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

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 PowerShellu Windows 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 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 v souboru Azure zachováte vlastnosti SMB místního souboru (atributy souboru, čas vytvoření souboru, čas posledního zápisu souboru).

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

Tento příklad nahraje místní soubor do souboru Azure a zachová v souboru Azure vlastnosti SMB místního souboru (atributy souboru, čas vytvoření souboru, čas posledního zápisu souboru).

Příklad 4: Nahrání souboru se souborem FileMode, vlastníkem a skupinou do sdílené složky NFS

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

Tento příkaz nahraje místní soubor do souboru Azure pomocí FileMode rwxrwSrwx, Vlastník 1 a Skupina 1. FileMode, Owner, Group funguje jenom ve sdílené složce NFS.

Parametry

-AsJob

Spusťte rutinu na pozadí.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Nullable<T>[Int32]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	ClientTimeoutPerRequestInSeconds

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Nullable<T>[Int32]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Confirm

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Context

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

Vlastnosti parametru

Typ:	IStorageContext
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

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

Vlastnosti parametru

Typ:	IAzureContextContainer
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DisAllowTrailingDot

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ShareName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FileMode

Platí jenom pro soubory NFS. Oprávnění režimu, která se mají nastavit v souboru. Podporuje se symbolický symbol (rwxrw-rw-).

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Force

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Group

Platí jenom pro soubory NFS. Identifikátor skupiny vlastníka (GID), který se má nastavit v souboru. Výchozí hodnota je 0 (kořenová skupina).

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Owner

Platí jenom pro soubory NFS. Identifikátor uživatele vlastníka (UID), který se má v souboru nastavit. Výchozí hodnota je 0 (kořen).

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PassThru

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	2
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PreserveSMBAttribute

Ponechte vlastnosti SMB zdrojového souboru (atributy souboru, čas vytvoření souboru, čas posledního zápisu souboru) v cílovém souboru. Tento parametr je k dispozici pouze ve Windows.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ServerTimeoutPerRequest

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

Vlastnosti parametru

Typ:	Nullable<T>[Int32]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	ServerTimeoutPerRequestInSeconds

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ShareClient

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

Vlastnosti parametru

Typ:	ShareClient
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Share

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ShareDirectoryClient

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

Vlastnosti parametru

Typ:	ShareDirectoryClient
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Directory

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ShareName

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Source

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Celé jméno

Sady parametrů

(All)

Position:	1
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

ShareClient

ShareDirectoryClient

String

IStorageContext

Výstupy

AzureStorageFile

Související odkazy

• Remove-AzStorageDirectory
• New-AzStorageDirectory
• Get-AzStorageFileContent