Compartilhar via

Set-AzStorageFileContent

  • Referência
Módulo:
Az.Storage

Carrega o conteúdo de um arquivo.

Sintaxe

Set-AzStorageFileContent
   [-ShareName] <String>
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Set-AzStorageFileContent
   [-ShareClient] <ShareClient>
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Set-AzStorageFileContent
   [-ShareDirectoryClient] <ShareDirectoryClient>
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Description

O cmdlet Set-AzStorageFileContent carrega o conteúdo de um arquivo em um arquivo em um compartilhamento especificado.

Exemplos

Exemplo 1: Carregar um arquivo na pasta atual

Set-AzStorageFileContent -ShareName "ContosoShare06" -Source "DataFile37" -Path "ContosoWorkingFolder/CurrentDataFile"

Esse comando carrega um arquivo chamado DataFile37 na pasta atual como um arquivo chamado CurrentDataFile na pasta denominada ContosoWorkingFolder.

Exemplo 2: Carregar todos os arquivos na pasta atual

$CurrentFolder = (Get-Item .).FullName
$Container = Get-AzStorageShare -Name "ContosoShare06"
Get-ChildItem -Recurse | Where-Object { $_.GetType().Name -eq "FileInfo"} | ForEach-Object {
    $path=$_.FullName.Substring($Currentfolder.Length+1).Replace("\","/")
    Set-AzStorageFileContent -ShareClient $Container -Source $_.FullName -Path $path -Force
}

Este exemplo usa vários cmdlets comuns do Windows PowerShell e o cmdlet atual para carregar todos os arquivos da pasta atual para a pasta raiz do contêiner ContosoShare06. O primeiro comando obtém o nome da pasta atual e o armazena na variável $CurrentFolder. O segundo comando usa o cmdlet Get-AzStorageShare para obter o compartilhamento de arquivos chamado ContosoShare06 e, em seguida, armazena-o na variável $Container. O comando final obtém o conteúdo da pasta atual e passa cada um para o cmdlet Where-Object usando o operador de pipeline. Esse cmdlet filtra objetos que não são arquivos e passa os arquivos para o cmdlet ForEach-Object. Esse cmdlet executa um bloco de script para cada arquivo que cria o caminho apropriado para ele e usa o cmdlet atual para carregar o arquivo. O resultado tem o mesmo nome e a mesma posição relativa em relação aos outros arquivos que este exemplo carrega. Para obter mais informações sobre blocos de script, digite Get-Help about_Script_Blocks.

Exemplo 3: carregue um arquivo local em um arquivo do Azure e perserve as propriedades locais de SMB de Arquivo (Atributos de Arquivo, Hora de Criação de Arquivo, Hora da Última Gravação do Arquivo) no arquivo do Azure.

Set-AzStorageFileContent -Source $localFilePath -ShareName sample -Path "dir1/file1" -PreserveSMBAttribute

Este exemplo carrega um arquivo local em um arquivo do Azure e reserva as propriedades locais de SMB de Arquivo (Atributos de Arquivo, Hora de Criação de Arquivo, Hora da Última Gravação do Arquivo) no arquivo do Azure.

Parâmetros

-AsJob

Execute o cmdlet em segundo plano.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 repetirá a solicitação. Se esse cmdlet não receber uma resposta bem-sucedida antes que o intervalo se esgote, esse cmdlet retornará um erro.

Tipo:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 de CPU e 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 de núcleos. Esse parâmetro pode ajudar a reduzir problemas de conexão de rede em ambientes de baixa largura de banda, como 100 quilobits por segundo. O valor padrão é 10.

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Context

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

Tipo:IStorageContext
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisAllowTrailingDot

Não permitir o ponto à direita (.) para sufixo de diretório e nomes de arquivo.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Indica que esse cmdlet substitui um arquivo de armazenamento existente do Azure.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Indica que esse cmdlet retorna o objeto AzureStorageFile que ele cria ou carrega.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Path

Especifica o caminho de um arquivo ou pasta. Esse cmdlet carrega conteúdo para o arquivo especificado por esse parâmetro ou para um arquivo na pasta especificada por esse parâmetro. Se você especificar uma pasta, esse cmdlet criará um arquivo com o mesmo nome do arquivo de origem. Se você especificar um caminho de um arquivo que não existe, esse cmdlet criará esse arquivo e salvará o conteúdo nesse arquivo. Se você especificar um arquivo que já existe e especificar o parâmetro Force, esse cmdlet substituirá o conteúdo do arquivo. Se você especificar um arquivo que já existe e não especificar Forçar, esse cmdlet não fará nenhuma alteração e retornará um erro. Se você especificar um caminho de uma pasta que não existe, esse cmdlet não fará nenhuma alteração e retornará um erro.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PreserveSMBAttribute

Mantenha as propriedades SMB do arquivo de origem (Atributos de Arquivo, Hora de Criação do Arquivo, Hora da Última Gravação do Arquivo) no arquivo de destino. Esse parâmetro só está disponível no Windows.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServerTimeoutPerRequest

Especifica o período de tempo limite para a parte do servidor de uma solicitação.

Tipo:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ShareClient

O objeto ShareClient indicou o compartilhamento no qual o arquivo seria carregado.

Tipo:ShareClient
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ShareDirectoryClient

O objeto ShareDirectoryClient indicou o diretório em que o arquivo seria carregado.

Tipo:ShareDirectoryClient
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ShareName

Especifica o nome do compartilhamento de arquivos. Esse cmdlet é carregado em um arquivo no compartilhamento de arquivos especificado por esse parâmetro.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Source

Especifica o arquivo de origem que este cmdlet carrega. Se você especificar um arquivo que não existe, esse cmdlet retornará um erro.

Tipo:String
Aliases:FullName
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

ShareClient

ShareDirectoryClient

String

IStorageContext

Saídas

AzureStorageFile