Get-AzureStorageFileContent
Baixa o conteúdo de um arquivo.
Aviso
O módulo AzureRM PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.
Syntax
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>] Description
O cmdlet Get-AzureStorageFileContent baixa o conteúdo de um arquivo e o salva em um destino que você especificar. Este cmdlet não retorna o conteúdo do arquivo.
Exemplos
Exemplo 1: Transferir um ficheiro a partir de uma pasta
PS C:\>Get-AzureStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"Este comando baixa um arquivo chamado CurrentDataFile na pasta ContosoWorkingFolder do compartilhamento de arquivos ContosoShare06 para a pasta atual.
Exemplo 2: Baixe os arquivos em compartilhamento de arquivos de exemplo
PS C:\>Get-AzureStorageFile -ShareName sample | ? {$_.GetType().Name -eq "CloudFile"} | Get-AzureStorageFileContentEste exemplo baixa os arquivos em compartilhamento de arquivos de exemplo
Parâmetros
-CheckMd5
Se você especificar o caminho de um arquivo que não existe, esse cmdlet criará esse arquivo e salvará o conteúdo no novo arquivo. Se você especificar um caminho de um arquivo que já existe e especificar o parâmetro Force , o cmdlet substituirá o arquivo. Se você especificar um caminho de um arquivo existente e não especificar Force, o cmdlet solicitará antes que ele continue. Se você especificar o caminho de uma pasta, esse cmdlet tentará criar um arquivo com o nome do arquivo de armazenamento do Azure.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClientTimeoutPerRequest
Se você especificar o caminho de um arquivo que não existe, esse cmdlet criará esse arquivo e salvará o conteúdo no novo arquivo. Se você especificar um caminho de um arquivo que já existe e especificar o parâmetro Force , o cmdlet substituirá o arquivo. Se você especificar um caminho de um arquivo existente e não especificar Force, o cmdlet solicitará antes que ele continue. Se você especificar o caminho de uma pasta, esse cmdlet tentará criar um arquivo com o nome do arquivo de armazenamento do Azure.
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConcurrentTaskCount
Se você especificar o caminho de um arquivo que não existe, esse cmdlet criará esse arquivo e salvará o conteúdo no novo arquivo. Se você especificar um caminho de um arquivo que já existe e especificar o parâmetro Force , o cmdlet substituirá o arquivo. Se você especificar um caminho de um arquivo existente e não especificar Force, o cmdlet solicitará antes que ele continue. Se você especificar o caminho de uma pasta, esse cmdlet tentará criar um arquivo com o nome do arquivo de armazenamento do Azure.
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Context
Se você especificar o caminho de um arquivo que não existe, esse cmdlet criará esse arquivo e salvará o conteúdo no novo arquivo. Se você especificar um caminho de um arquivo que já existe e especificar o parâmetro Force , o cmdlet substituirá o arquivo. Se você especificar um caminho de um arquivo existente e não especificar Force, o cmdlet solicitará antes que ele continue. Se você especificar o caminho de uma pasta, esse cmdlet tentará criar um arquivo com o nome do arquivo de armazenamento do Azure.
| Type: | IStorageContext |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Destination
Especifica o caminho de destino. Este cmdlet baixa o conteúdo do arquivo para o local especificado por esse parâmetro. Se você especificar o caminho de um arquivo que não existe, esse cmdlet criará esse arquivo e salvará o conteúdo no novo arquivo. Se você especificar um caminho de um arquivo que já existe e especificar o parâmetro Force , o cmdlet substituirá o arquivo. Se você especificar um caminho de um arquivo existente e não especificar Force, o cmdlet solicitará antes que ele continue. Se você especificar o caminho de uma pasta, esse cmdlet tentará criar um arquivo com o nome do arquivo de armazenamento do Azure.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Directory
Especifica uma pasta como um objeto CloudFileDirectory . Este cmdlet obtém conteúdo para um arquivo na pasta especificada por esse parâmetro. Para obter um diretório, use o cmdlet New-AzureStorageDirectory. Você também pode usar o cmdlet Get-AzureStorageFile para obter um diretório.
| Type: | CloudFileDirectory |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-File
Especifica um arquivo como um objeto CloudFile . Este cmdlet obtém o arquivo especificado por esse parâmetro. Para obter um objeto CloudFile , use o cmdlet Get-AzureStorageFile.
| Type: | CloudFile |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Se você especificar o caminho de um arquivo que não existe, esse cmdlet criará esse arquivo e salvará o conteúdo no novo arquivo. Se você especificar um caminho de um arquivo que já existe e especificar o parâmetro Force , o cmdlet substituirá o arquivo. Se você especificar um caminho de um arquivo existente e não especificar Force, o cmdlet solicitará antes que ele continue. Se você especificar o caminho de uma pasta, esse cmdlet tentará criar um arquivo com o nome do arquivo de armazenamento do Azure.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Se você especificar o caminho de um arquivo que não existe, esse cmdlet criará esse arquivo e salvará o conteúdo no novo arquivo. Se você especificar um caminho de um arquivo que já existe e especificar o parâmetro Force , o cmdlet substituirá o arquivo. Se você especificar um caminho de um arquivo existente e não especificar Force, o cmdlet solicitará antes que ele continue. Se você especificar o caminho de uma pasta, esse cmdlet tentará criar um arquivo com o nome do arquivo de armazenamento do Azure.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Especifica o caminho de um ficheiro. Este cmdlet obtém o conteúdo do arquivo especificado por esse parâmetro. Se o arquivo não existir, esse cmdlet retornará um erro.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServerTimeoutPerRequest
Se você especificar o caminho de um arquivo que não existe, esse cmdlet criará esse arquivo e salvará o conteúdo no novo arquivo. Se você especificar um caminho de um arquivo que já existe e especificar o parâmetro Force , o cmdlet substituirá o arquivo. Se você especificar um caminho de um arquivo existente e não especificar Force, o cmdlet solicitará antes que ele continue. Se você especificar o caminho de uma pasta, esse cmdlet tentará criar um arquivo com o nome do arquivo de armazenamento do Azure.
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Share
Especifica um objeto CloudFileShare . Este cmdlet baixa o conteúdo do arquivo no compartilhamento especificado por este parâmetro. Para obter um objeto CloudFileShare , use o cmdlet Get-AzureStorageShare. Este objeto contém o contexto de armazenamento. Se você especificar esse parâmetro, não especifique o parâmetro Context .
| Type: | CloudFileShare |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ShareName
Especifica o nome do compartilhamento de arquivos. Este cmdlet baixa o conteúdo do arquivo no compartilhamento especificado por este parâmetro.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Parâmetros: Share (ByValue)
Parâmetros: Diretório (ByValue)
Parâmetros: File (ByValue)