Share via

Remove-AzStorageFile

  • Referência
Módulo:
Az.Storage

Exclui um arquivo.

Syntax

Remove-AzStorageFile
      [-ShareName] <String>
      [-Path] <String>
      [-PassThru]
      [-DisAllowTrailingDot]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzStorageFile
      [-Share] <CloudFileShare>
      [-ShareClient <ShareClient>]
      [-Path] <String>
      [-PassThru]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzStorageFile
      [-Directory] <CloudFileDirectory>
      [-ShareDirectoryClient <ShareDirectoryClient>]
      [-Path] <String>
      [-PassThru]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzStorageFile
      [-File] <CloudFile>
      [-ShareFileClient <ShareFileClient>]
      [-PassThru]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-AzStorageFile exclui um arquivo.

Exemplos

Exemplo 1: Excluir um arquivo de um compartilhamento de arquivos

Remove-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoFile22"

Este comando exclui o arquivo chamado ContosoFile22 do compartilhamento de arquivos chamado ContosoShare06.

Exemplo 2: Obter um arquivo de um compartilhamento de arquivos usando um objeto de compartilhamento de arquivos

Get-AzStorageShare -Name "ContosoShare06" | Remove-AzStorageFile -Path "ContosoFile22"

Este comando usa o cmdlet Get-AzStorageShare para obter o compartilhamento de arquivos chamado ContosoShare06 e, em seguida, passa esse objeto para o cmdlet atual usando o operador de pipeline. O comando atual exclui o arquivo chamado ContosoFile22 de ContosoShare06.

Parâmetros

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

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 predefinido é 10.

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

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 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 . Este cmdlet remove um arquivo na pasta especificada por esse parâmetro.

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

-DisAllowTrailingDot

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

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

-File

Especifica um arquivo como um objeto CloudFile . Este cmdlet remove o arquivo especificado por esse parâmetro. Para obter um objeto CloudFile , use o cmdlet Get-AzStorageFile.

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

-PassThru

Indica que esse cmdlet retorna um Boolean que reflete o sucesso da operação. Por padrão, esse cmdlet não retorna um valor.

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 exclui o arquivo especificado por esse parâmetro.

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

-ServerTimeoutPerRequest

Especifica o 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 . Este cmdlet remove o 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 .

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 onde o arquivo seria removido.

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

-ShareDirectoryClient

O objeto ShareDirectoryClient indicou a pasta base onde o arquivo seria removido.

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

-ShareFileClient

O objeto ShareFileClient indicou que o arquivo seria removido.

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

-ShareName

Especifica o nome do compartilhamento de arquivos. Este cmdlet remove o 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

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

Saídas

AzureStorageFile