Partilhar via


Set-AzStorageFileContent

Carrega o conteúdo de um arquivo.

Sintaxe

ShareName (Padrão)

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

Share

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

Directory

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

Descrição

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"

Este 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 -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 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 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 preserve as propriedades SMB do Arquivo local (Atributos do Arquivo, Hora de Criação do 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 preserva as propriedades SMB do arquivo local (Atributos do arquivo, Hora da criação do arquivo, Hora da última gravação do arquivo) no arquivo do Azure.

Exemplo 4: Carregar um arquivo com FileMode, Owner e Group para um compartilhamento de arquivos NFS

Set-AzStorageFileContent -ShareName "contososhare06" -Source "DataFile37" -Path "ContosoWorkingFolder/CurrentDataFile" -FileMode rw-r--rwt -Owner 1 -Group 1

Este comando carrega um arquivo local em um arquivo do Azure com FileMode rwxrwSrwx, Proprietário 1 e Grupo 1. FileMode, Owner, Group só funciona em compartilhamento de arquivos NFS.

Parâmetros

-AsJob

Execute o cmdlet em segundo plano.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades dos parâmetros

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:ClientTimeoutPerRequestInSeconds

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades dos parâmetros

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:False
Suporta curingas:False
DontShow:False
Pseudónimos:Cf.

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Context

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

Propriedades dos parâmetros

Tipo:IStorageContext
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-DisAllowTrailingDot

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ShareName
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-FileMode

Aplicável apenas a ficheiros NFS. As permissões de modo a serem definidas no arquivo. Simbólico (rwxrw-rw-) é suportado.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Force

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Group

Aplicável apenas a ficheiros NFS. O identificador de grupo de proprietários (GID) a ser definido no arquivo. O valor padrão é 0 (grupo raiz).

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Owner

Aplicável apenas a ficheiros NFS. O identificador de usuário proprietário (UID) a ser definido no arquivo. O valor padrão é 0 (raiz).

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-PassThru

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Path

Especifica o caminho de um arquivo ou pasta. Este 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 Force, 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.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-PreserveSMBAttribute

Mantenha as propriedades SMB do arquivo de origem (atributos do arquivo, tempo de criação do arquivo, hora da última gravação do arquivo) no arquivo de destino. Este parâmetro só está disponível no Windows.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ServerTimeoutPerRequest

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

Propriedades dos parâmetros

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:ServerTimeoutPerRequestInSeconds

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ShareClient

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

Propriedades dos parâmetros

Tipo:ShareClient
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

Share
Posição:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-ShareDirectoryClient

O objeto ShareDirectoryClient indicava o diretório onde o arquivo seria carregado.

Propriedades dos parâmetros

Tipo:ShareDirectoryClient
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

Directory
Posição:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-ShareName

Especifica o nome do compartilhamento de arquivos. Este cmdlet é carregado para um arquivo no compartilhamento de arquivos especificado por este parâmetro.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ShareName
Posição:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:Nome Completo

Conjuntos de parâmetros

(All)
Posição:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:False
Suporta curingas:False
DontShow:False
Pseudónimos:Wi

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

ShareClient

ShareDirectoryClient

String

IStorageContext

Saídas

AzureStorageFile