Set-AzStorageFileContent

Carrega o conteúdo de um arquivo.

Syntax

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
   [-Share] <CloudFileShare>
   [-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
   [-Directory] <CloudFileDirectory>
   [-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 chamada 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 -Share $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 o armazena 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, em seguida, 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, em seguida, 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 carregados neste exemplo. 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 examine as propriedades locais do SMB do 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 examina as propriedades SMB de Arquivo locais (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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 esse cmdlet não receber uma resposta bem-sucedida antes que o intervalo transcorra, ele retornará um erro.

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

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita 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

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

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

-Directory

Especifica uma pasta como um objeto CloudFileDirectory . Esse cmdlet carrega o 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.

Type:CloudFileDirectory
Aliases:CloudFileDirectory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DisAllowTrailingDot

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Especifica o caminho de um arquivo ou pasta. Esse cmdlet carrega conteúdo no arquivo especificado por esse parâmetro ou em 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.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreserveSMBAttribute

Mantenha as propriedades SMB do arquivo de origem (Atributos do 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

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

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Share

Especifica um objeto CloudFileShare . Esse cmdlet é carregado em um arquivo no compartilhamento de arquivos especificado por esse 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 .

Type:CloudFileShare
Aliases:CloudFileShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareClient

O objeto ShareClient indicava o compartilhamento para o qual o arquivo seria carregado.

Type:ShareClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareDirectoryClient

O objeto CloudFileDirectory indicava o diretório na nuvem onde o arquivo seria carregado.

Type:ShareDirectoryClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Source

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

Type:String
Aliases:FullName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. 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

CloudFileShare

CloudFileDirectory

String

IStorageContext

Saídas

AzureStorageFile