Compartilhar via

Get-AzStorageFileContent

  • Referência
Módulo:
Az.Storage

Baixa o conteúdo de um arquivo.

Sintaxe

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

Description

O cmdlet Get-AzStorageFileContent baixa o conteúdo de um arquivo e o salva em um destino especificado. Este cmdlet não retorna o conteúdo do arquivo.

Exemplos

Exemplo 1: Transferir um ficheiro a partir de uma pasta

Get-AzStorageFileContent -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: Transfere os ficheiros em partilha de ficheiros de exemplo

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

Este exemplo baixa os arquivos em compartilhamento de arquivos de exemplo

Exemplo 3: Baixe um arquivo do Azure para um arquivo local e examine as propriedades SMB do Arquivo do Azure (Atribuições de Arquivo, Hora de Criação do Arquivo, Hora da Última Gravação do Arquivo) no arquivo local.

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

Este exemplo baixa um arquivo do Azure para um arquivo local e conserva as propriedades SMB do Arquivo do Azure (Atribuições de Arquivo, Hora de Criação do Arquivo, Hora da Última Gravação do Arquivo) no arquivo local.

Parâmetros

-AsJob

Execute o cmdlet em segundo plano.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CheckMd5

Especifica se a soma Md5 do arquivo baixado deve ser verificada.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ClientTimeoutPerRequest

Especifica o intervalo de tempo limite do lado do cliente, em segundos, para uma solicitação de serviço. Se a chamada anterior falhar no intervalo especificado, esse cmdlet tentará novamente a solicitação. Se este cmdlet não receber uma resposta bem-sucedida antes do intervalo passar, ele retornará um erro.

Tipo:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ConcurrentTaskCount

Especifica o máximo de chamadas de rede simultâneas. Você pode usar esse parâmetro para limitar a simultaneidade para limitar o uso local da CPU e da largura de banda, especificando o número máximo de chamadas de rede simultâneas. O valor especificado é uma contagem absoluta e não é multiplicado pela contagem principal. Esse parâmetro pode ajudar a reduzir problemas de conexão de rede em ambientes de baixa largura de banda, como 100 kilobits por segundo. O valor predefinido é 10.

Tipo:Nullable<T>[Int32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Context

Especifica um contexto de Armazenamento do Azure. Para obter um contexto, use o cmdlet New-AzStorageContext.

Tipo:IStorageContext
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:String
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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-AzStorageDirectory. Você também pode usar o cmdlet Get-AzStorageFile para obter um diretório.

Tipo:CloudFileDirectory
Aliases:CloudFileDirectory
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DisAllowTrailingDot

Não permita que o ponto à direita (.) sufixe nomes de diretório e arquivo.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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-AzStorageFile.

Tipo:CloudFile
Aliases:CloudFile
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PassThru

Indica que esse cmdlet retorna o objeto AzureStorageFile baixado.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PreserveSMBAttribute

Mantenha as propriedades SMB do arquivo de origem (File Attributtes, File Creation Time, File Last Write Time) no arquivo de destino. Este parâmetro só está disponível no Windows.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServerTimeoutPerRequest

Especifica o intervalo de tempo limite do lado do serviço, em segundos, para uma solicitação. Se o intervalo especificado decorrer antes de o serviço processar a solicitação, o serviço de armazenamento retornará um erro.

Tipo:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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-AzStorageShare. Este objeto contém o contexto de armazenamento. Se você especificar esse parâmetro, não especifique o parâmetro Context .

Tipo:CloudFileShare
Aliases:CloudFileShare
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ShareClient

O objeto CloudFileShare indicava o compartilhamento onde o arquivo seria baixado.

Tipo:ShareClient
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ShareDirectoryClient

O objeto ShareDirectoryClient indicava o diretório na nuvem onde o arquivo seria baixado.

Tipo:ShareDirectoryClient
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ShareFileClient

O objeto ShareFileClient indicou o arquivo na nuvem a ser baixado.

Tipo:ShareFileClient
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ShareName

Especifica o nome do compartilhamento de arquivos. Este cmdlet baixa o conteúdo do arquivo no compartilhamento especificado por este parâmetro.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

Saídas

AzureStorageFile