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

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.

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

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

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

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: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-Azure Archiviazione Directory. È anche possibile usare il cmdlet Get-Azure Archiviazione File per ottenere una directory.

Type:CloudFileDirectory
Position:0
Default value:None
Required:True
Accept pipeline input:True
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-Azure Archiviazione File.

Type: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

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

-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

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

Type:Nullable<T>[Int32]
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-Azure Archiviazione Share. Questo oggetto contiene il contesto di archiviazione. Se si specifica questo parametro, non specificare il parametro Context .

Type:CloudFileShare
Position:0
Default value:None
Required:True
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

Parametri: Share (ByValue)

CloudFileDirectory

Parametri: Directory (ByValue)

CloudFile

Parametri: File (ByValue)

IStorageContext

Output

CloudFile