Condividi tramite

Get-AzStorageFileContent

Modulo:
Az.Storage Module

Scarica il contenuto di un file.

Sintassi

ShareName (impostazione predefinita). 

Get-AzStorageFileContent
    [-ShareName] <String>
    [-Path] <String>
    [[-Destination] <String>]
    [-CheckMd5]
    [-PassThru]
    [-Force]
    [-AsJob]
    [-DisAllowTrailingDot]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [-PreserveSMBAttribute]
    [<CommonParameters>]

Share 

Get-AzStorageFileContent
    [-ShareClient] <ShareClient>
    [-Path] <String>
    [[-Destination] <String>]
    [-CheckMd5]
    [-PassThru]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [-PreserveSMBAttribute]
    [<CommonParameters>]

Directory 

Get-AzStorageFileContent
    [-ShareDirectoryClient] <ShareDirectoryClient>
    [-Path] <String>
    [[-Destination] <String>]
    [-CheckMd5]
    [-PassThru]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [-PreserveSMBAttribute]
    [<CommonParameters>]

File 

Get-AzStorageFileContent
    [-ShareFileClient] <ShareFileClient>
    [[-Destination] <String>]
    [-CheckMd5]
    [-PassThru]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [-PreserveSMBAttribute]
    [<CommonParameters>]

Descrizione

Il cmdlet Get-AzStorageFileContent scarica il contenuto di un file e quindi lo salva in una destinazione specificata. Questo cmdlet non restituisce il contenuto del file.

Esempio

Esempio 1: Scaricare un file da una cartella

Get-AzStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"

Questo comando scarica un file denominato CurrentDataFile nella cartella ContosoWorkingFolder dalla condivisione file ContosoShare06 alla cartella corrente.

Esempio 2: Scarica i file nella condivisione file di esempio

Get-AzStorageFile -ShareName sample | Where-Object {$_.GetType().Name -eq "AzureStorageFile"} | Get-AzStorageFileContent

Questo esempio scarica i file nella condivisione file di esempio

Esempio 3: Scaricare un file di Azure in un file locale e mantenere le proprietà SMB del file di Azure (attributi file, ora di creazione file, ora ultima scrittura file) nel file locale.

Get-AzStorageFileContent -ShareName sample -Path "dir1/file1" -Destination $localFilePath -PreserveSMBAttribute

Questo esempio scarica un file di Azure in un file locale e mantiene le proprietà SMB del file di Azure (attributi file, ora di creazione file, ora ultima scrittura file) nel file locale.

Parametri

-AsJob

Eseguire il cmdlet in background.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CheckMd5

Specifica se controllare la somma Md5 per il file scaricato.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:

Nullable<T>[Int32]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:

Nullable<T>[Int32]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Context

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

Proprietà dei parametri

Tipo:IStorageContext
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-DefaultProfile

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

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Destination

Specifica il percorso di destinazione. Questo cmdlet scarica il contenuto del file nel percorso specificato da questo parametro. Se si specifica il percorso di un file che non esiste, questo cmdlet crea tale file e salva il contenuto nel nuovo file. Se si specifica un percorso di un file già esistente e si specifica il parametro Force, il cmdlet sovrascrive il file. Se si specifica un percorso di un file esistente e non si specifica Force, il cmdlet richiede di continuare. Se si specifica il percorso di una cartella, questo cmdlet tenta di creare un file con il nome del file di archiviazione di Azure.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:2
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DisAllowTrailingDot

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ShareName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Force

Se si specifica il percorso di un file che non esiste, questo cmdlet crea tale file e salva il contenuto nel nuovo file. Se si specifica un percorso di un file già esistente e si specifica il parametro Force, il cmdlet sovrascrive il file. Se si specifica un percorso di un file esistente e non si specifica Force, il cmdlet richiede di continuare. Se si specifica il percorso di una cartella, questo cmdlet tenta di creare un file con il nome del file di archiviazione di Azure.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PassThru

Indica che questo cmdlet restituisce l'oggetto AzureStorageFile scaricato.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Path

Specifica il percorso di un file. Questo cmdlet ottiene il contenuto del file specificato da questo parametro. Se il file non esiste, questo cmdlet restituisce un errore.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ShareName
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
Share
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
Directory
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PreserveSMBAttribute

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ServerTimeoutPerRequest

Specifica l'intervallo di timeout sul lato servizio, espresso in secondi, per una richiesta. Se l'intervallo specificato è trascorso prima che il servizio elabori la richiesta, il servizio di archiviazione restituisce un errore.

Proprietà dei parametri

Tipo:

Nullable<T>[Int32]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ShareClient

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

Proprietà dei parametri

Tipo:ShareClient
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Share
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ShareDirectoryClient

L'oggetto ShareDirectoryClient indica la directory cloud in cui verrà scaricato il file.

Proprietà dei parametri

Tipo:ShareDirectoryClient
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Directory
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ShareFileClient

L'oggetto ShareFileClient indica il file cloud da scaricare.

Proprietà dei parametri

Tipo:ShareFileClient
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

File
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ShareName

Specifica il nome della condivisione file. Questo cmdlet scarica il contenuto del file nella condivisione specificata da questo parametro.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ShareName
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

ShareClient

ShareDirectoryClient

ShareFileClient

IStorageContext

Output

AzureStorageFile