Remove-AzStorageFile
Sintaxe
ShareName (Default)
Remove-AzStorageFile
[-ShareName] <String>
[-Path] <String>
[-PassThru]
[-DisAllowTrailingDot]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Share
Remove-AzStorageFile
[-ShareClient] <ShareClient>
[-Path] <String>
[-PassThru]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Directory
Remove-AzStorageFile
[-ShareDirectoryClient] <ShareDirectoryClient>
[-Path] <String>
[-PassThru]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
File
Remove-AzStorageFile
[-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 arquivo
Remove-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoFile22"
Esse comando exclui o arquivo chamado ContosoFile22 do compartilhamento de arquivos chamado ContosoShare06.
Exemplo 2: Obter um arquivo de um compartilhamento de arquivo usando um objeto de compartilhamento de arquivo
Get-AzStorageShare -Name "ContosoShare06" | Remove-AzStorageFile -Path "ContosoFile22"
Esse 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 da 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 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.
Propriedades do parâmetro
Tipo: Nullable<T> [ Int32 ]
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: ClientTimeoutPerRequestInSeconds
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo 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 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.
Propriedades do parâmetro
Tipo: Nullable<T> [ Int32 ]
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: False Dá suporte a curingas: False DontShow: False Aliases: cf
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo 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 do parâmetro
Tipo: IStorageContext
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: True Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
Propriedades do parâmetro
Tipo: IAzureContextContainer
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DisAllowTrailingDot
Não permitir o ponto à direita (.) para sufixo de diretório e nomes de arquivo.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ShareName
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-PassThru
Indica que esse cmdlet retorna um booliano que reflete o sucesso da operação.
Por padrão, esse cmdlet não retorna um valor.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Path
Especifica o caminho de um arquivo.
Esse cmdlet exclui o arquivo especificado por esse parâmetro.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ShareName
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
Share
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
Directory
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo 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 do parâmetro
Tipo: Nullable<T> [ Int32 ]
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: ServerTimeoutPerRequestInSeconds
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-ShareClient
O objeto ShareClient indicou o compartilhamento em que o arquivo seria removido.
Propriedades do parâmetro
Tipo: ShareClient
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
Share
Cargo: 0 Obrigatório: True Valor do pipeline: True Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-ShareDirectoryClient
O objeto ShareDirectoryClient indicou a pasta base em que o arquivo seria removido.
Propriedades do parâmetro
Conjuntos de parâmetros
Directory
Cargo: 0 Obrigatório: True Valor do pipeline: True Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-ShareFileClient
O objeto ShareFileClient indicou que o arquivo seria removido.
Propriedades do parâmetro
Tipo: ShareFileClient
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
File
Cargo: 0 Obrigatório: True Valor do pipeline: True Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-ShareName
Especifica o nome do compartilhamento de arquivos.
Esse cmdlet remove o arquivo no compartilhamento especificado por esse parâmetro.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ShareName
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: False Dá suporte a curingas: False DontShow: False Aliases: wi
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo 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 .
Saídas
