Condividi tramite


Get-AzureStorageFileContent

Scarica il contenuto di un file.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Get-AzureStorageFileContent
   [-ShareName] <String>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-Share] <CloudFileShare>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-File] <CloudFile>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-AzureStorageFileContent 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

PS C:\>Get-AzureStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"

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

Esempio 2: Scaricare i file nella condivisione file di esempio

PS C:\>Get-AzureStorageFile -ShareName sample | ? {$_.GetType().Name -eq "CloudFile"} | Get-AzureStorageFileContent

Questo esempio scarica i file nella condivisione file di esempio

Parametri

-CheckMd5

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.

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

-ClientTimeoutPerRequest

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.

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

-ConcurrentTaskCount

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.

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

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.

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

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

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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-AzureStorageDirectory. È anche possibile usare il cmdlet Get-AzureStorageFile per ottenere una directory.

Tipo:CloudFileDirectory
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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-AzureStorageFile.

Tipo:CloudFile
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.

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

-PassThru

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.

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. Questo cmdlet ottiene il contenuto del file specificato da questo parametro. Se il file non esiste, questo cmdlet restituisce un errore.

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

-ServerTimeoutPerRequest

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.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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-AzureStorageShare . Questo oggetto contiene il contesto di archiviazione. Se si specifica questo parametro, non specificare il parametro Context .

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

-ShareName

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

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
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

Parametri: Share (ByValue)

CloudFileDirectory

Parametri: Directory (ByValue)

CloudFile

Parametri: File (ByValue)

IStorageContext

Output

CloudFile