Get-AzStorageFileContent

Scarica il contenuto di un file.

Sintassi

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>]
Get-AzStorageFileContent
   [-Share] <CloudFileShare>
   [-ShareClient <ShareClient>]
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Get-AzStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-ShareDirectoryClient <ShareDirectoryClient>]
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Get-AzStorageFileContent
   [-File] <CloudFile>
   [-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-Az Archiviazione FileContent 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 "CloudFile"} | Get-AzStorageFileContent

Questo esempio scarica i file nella condivisione file di esempio

Esempio 3: Scaricare un file di Azure in un file locale e conservare le proprietà SMB del file di Azure (Attributtes, Ora 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 conserva le proprietà SMB del file di Azure (File Attributtes, Ora creazione file, Ora ultima scrittura file) nel file locale.

Parametri

-AsJob

Eseguire il cmdlet in background.

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

-CheckMd5

Specifica se controllare la somma Md5 per il file scaricato.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-Context

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

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Directory

Specifica una cartella come oggetto CloudFileDirectory . Questo cmdlet ottiene il contenuto di un file nella cartella specificata da questo parametro. Per ottenere una directory, usare il cmdlet New-Az Archiviazione Directory. È anche possibile usare il cmdlet Get-Az Archiviazione File per ottenere una directory.

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

-DisAllowTrailingDot

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

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

-File

Specifica un file come oggetto CloudFile . Questo cmdlet ottiene il file specificato da questo parametro. Per ottenere un oggetto CloudFile, usare il cmdlet Get-Az Archiviazione File.

Type:CloudFile
Aliases:CloudFile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-PassThru

Indica che questo cmdlet restituisce l'oggetto Azure Archiviazione File scaricato.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Share

Specifica un oggetto CloudFileShare . Questo cmdlet scarica il contenuto del file nella condivisione specificata da questo parametro. Per ottenere un oggetto CloudFileShare, usare il cmdlet Get-Az Archiviazione Share. Questo oggetto contiene il contesto di archiviazione. Se si specifica questo parametro, non specificare il parametro Context .

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

-ShareClient

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

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

-ShareDirectoryClient

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

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

-ShareFileClient

L'oggetto ShareFileClient indica il file cloud da scaricare.

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

-ShareName

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

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

-WhatIf

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

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

Input

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

Output

AzureStorageFile