Condividi tramite

Set-AzStorageFileContent

  • Riferimento
Modulo:
Az.Storage

Carica il contenuto di un file.

Sintassi

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

Descrizione

Il cmdlet Set-AzStorageFileContent carica il contenuto di un file in un file in una condivisione specificata.

Esempio

Esempio 1: Caricare un file nella cartella corrente

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

Questo comando carica un file denominato DataFile37 nella cartella corrente come file denominato CurrentDataFile nella cartella denominata ContosoWorkingFolder.

Esempio 2: Caricare tutti i file nella cartella corrente

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

Questo esempio usa diversi cmdlet comuni di Windows PowerShell e il cmdlet corrente per caricare tutti i file dalla cartella corrente nella cartella radice del contenitore ContosoShare06. Il primo comando ottiene il nome della cartella corrente e lo archivia nella variabile $CurrentFolder. Il secondo comando usa il cmdlet Get-AzStorageShare per ottenere la condivisione file denominata ContosoShare06 e quindi la archivia nella variabile $Container. Il comando finale ottiene il contenuto della cartella corrente e passa ognuno al cmdlet Where-Object usando l'operatore pipeline. Tale cmdlet filtra gli oggetti che non sono file e quindi passa i file al cmdlet ForEach-Object. Tale cmdlet esegue un blocco di script per ogni file che crea il percorso appropriato e quindi usa il cmdlet corrente per caricare il file. Il risultato ha lo stesso nome e la stessa posizione relativa rispetto agli altri file caricati in questo esempio. Per altre informazioni sui blocchi di script, digitare Get-Help about_Script_Blocks.

Esempio 3: Caricare un file locale in un file di Azure e conservare le proprietà SMB del file locale (Attributtes, Ora creazione file, Ora ultima scrittura file) nel file di Azure.

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

Questo esempio carica un file locale in un file di Azure e conserva le proprietà SMB del file locale (File Attributtes, Ora creazione file, Ora ultima scrittura file) nel file di Azure.

Parametri

-AsJob

Eseguire il cmdlet in background.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClientTimeoutPerRequest

Specifica l'intervallo di timeout lato client, espresso in secondi, per una richiesta di servizio. Se la chiamata precedente ha esito negativo nell'intervallo specificato, questo cmdlet ritenta la richiesta. Se questo cmdlet non riceve una risposta corretta prima della scadenza dell'intervallo, questo cmdlet restituisce un errore.

Tipo:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ConcurrentTaskCount

Specifica il numero massimo di chiamate di rete simultanee. È possibile usare questo parametro per limitare la concorrenza per limitare l'utilizzo della CPU e della larghezza di banda locali specificando il numero massimo di chiamate di rete simultanee. Il valore specificato è un conteggio assoluto e non viene moltiplicato per il numero di core. Questo parametro consente di ridurre i problemi di connessione di rete in ambienti a larghezza di banda ridotta, ad esempio 100 kilobit al secondo. Il valore predefinito è 10.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Context

Specifica un contesto di archiviazione di Azure. Per ottenere un contesto di archiviazione, usare il cmdlet New-AzStorageContext .

Tipo:IStorageContext
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Directory

Specifica una cartella come oggetto CloudFileDirectory . Questo cmdlet carica il file nella cartella specificata da questo parametro. Per ottenere una directory, usare il cmdlet New-AzStorageDirectory. È anche possibile usare il cmdlet Get-AzStorageFile per ottenere una directory.

Tipo:CloudFileDirectory
Alias:CloudFileDirectory
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DisAllowTrailingDot

Non consentire il punto finale (.) per suffisso directory e nomi di file.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Indica che questo cmdlet sovrascrive un file di archiviazione di Azure esistente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Indica che questo cmdlet restituisce l'oggetto AzureStorageFile creato o caricato.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Specifica il percorso di un file o di una cartella. Questo cmdlet carica il contenuto nel file specificato da questo parametro o in un file nella cartella specificata da questo parametro. Se si specifica una cartella, questo cmdlet crea un file con lo stesso nome del file di origine. Se si specifica un percorso di un file che non esiste, questo cmdlet crea tale file e salva il contenuto in tale file. Se si specifica un file già esistente e si specifica il parametro Force , questo cmdlet sovrascrive il contenuto del file. Se si specifica un file già esistente e non si specifica Force, questo cmdlet non apporta alcuna modifica e restituisce un errore. Se si specifica un percorso di una cartella che non esiste, questo cmdlet non apporta alcuna modifica e restituisce un errore.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PreserveSMBAttribute

Mantenere le proprietà SMB del file di origine (File Attributtes, Ora creazione file, Ora ultima scrittura file) nel file di destinazione. Questo parametro è disponibile solo in Windows.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServerTimeoutPerRequest

Specifica la durata del periodo di timeout per la parte server di una richiesta.

Tipo:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Share

Specifica un oggetto CloudFileShare . Questo cmdlet carica in un file nella condivisione file questo parametro specifica. Per ottenere un oggetto CloudFileShare, usare il cmdlet Get-AzStorageShare . Questo oggetto contiene il contesto di archiviazione. Se si specifica questo parametro, non specificare il parametro Context .

Tipo:CloudFileShare
Alias:CloudFileShare
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ShareClient

L'oggetto ShareClient indica la condivisione in cui verrà caricato il file.

Tipo:ShareClient
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ShareDirectoryClient

L'oggetto CloudFileDirectory indica la directory cloud in cui verrà caricato il file.

Tipo:ShareDirectoryClient
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ShareName

Specifica il nome della condivisione file. Questo cmdlet carica in un file nella condivisione file questo parametro specifica.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Source

Specifica il file di origine caricato da questo cmdlet. Se si specifica un file che non esiste, questo cmdlet restituisce un errore.

Tipo:String
Alias:FullName
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

CloudFileShare

CloudFileDirectory

String

IStorageContext

Output

AzureStorageFile