Close-AzStorageFileHandle

Fecha identificadores de arquivo de um compartilhamento de arquivos, um diretório de arquivos ou um arquivo.

Syntax

Close-AzStorageFileHandle
     [-ShareName] <String>
     [[-Path] <String>]
     [-Recursive]
     [-CloseAll]
     [-Context <IStorageContext>]
     [-DisAllowTrailingDot]
     [-PassThru]
     [-AsJob]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Close-AzStorageFileHandle
     [-ShareName] <String>
     -FileHandle <PSFileHandle>
     [-Context <IStorageContext>]
     [-DisAllowTrailingDot]
     [-PassThru]
     [-AsJob]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Close-AzStorageFileHandle
     [-Share] <CloudFileShare>
     [-ShareClient <ShareClient>]
     [[-Path] <String>]
     [-Recursive]
     [-CloseAll]
     [-PassThru]
     [-AsJob]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Close-AzStorageFileHandle
     [-Share] <CloudFileShare>
     [-ShareClient <ShareClient>]
     -FileHandle <PSFileHandle>
     [-PassThru]
     [-AsJob]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Close-AzStorageFileHandle
     [-Directory] <CloudFileDirectory>
     [-ShareDirectoryClient <ShareDirectoryClient>]
     [[-Path] <String>]
     [-Recursive]
     [-CloseAll]
     [-PassThru]
     [-AsJob]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Close-AzStorageFileHandle
     [-File] <CloudFile>
     [-ShareFileClient <ShareFileClient>]
     [-CloseAll]
     [-PassThru]
     [-AsJob]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

O cmdlet Close-AzStorageFileHandle fecha identificadores de arquivo de um compartilhamento de arquivos, diretório de arquivos ou um arquivo.

Exemplos

Exemplo 1: Fechar todos os identificadores de arquivo em um arquivo

Close-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2/test.txt' -CloseAll

Esse comando fecha todos os identificadores de arquivo em um arquivo.

Exemplo 2: Feche todos os identificadores de arquivo abertos há 1 dia em um diretório de arquivos

Get-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2' -Recursive | Where-Object {$_.OpenTime.DateTime.AddDays(1) -lt (Get-Date)} | Close-AzStorageFileHandle -ShareName "mysharename"

Este comando lista todos os identificadores de arquivo em um diretório de arquivos recursivamente, filtra os identificadores que foram abertos há 1 dia e, em seguida, os fecha.

Exemplo 3: Feche todos os identificadores de arquivo em um diretório de arquivo recursivamente e mostre a contagem de identificadores de arquivo fechados

Close-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2' -Recursive -CloseAll -PassThru

10

Esse comando fecha todos os identificadores de arquivo em um diretório de arquivos e mostra a contagem de identificadores de arquivo fechados.

Exemplo 4: Fechar todos os identificadores de arquivo em um compartilhamento de arquivos

Close-AzStorageFileHandle -ShareName "mysharename" -CloseAll -Recursive

Esse comando fecha todos os identificadores de arquivo em um compartilhamento de arquivo específico recursivamente.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

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

-ClientTimeoutPerRequest

O tempo máximo de execução do lado do cliente para cada solicitação em segundos.

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

-CloseAll

Forçar o fechamento de todos os identificadores de arquivo.

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

-ConcurrentTaskCount

A quantidade total de tarefas assíncronas simultâneas. 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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Objeto de contexto do Armazenamento do Azure

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

O objeto CloudFileDirectory indicava a pasta base onde os arquivos/diretórios seriam listados.

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

-File

O objeto CloudFile indicou o arquivo a ser fechado.

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

-FileHandle

O identificador de arquivo a ser fechado.

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

-PassThru

Retornar a contagem de identificadores de arquivo fechados.

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

-Path

Caminho para um arquivo/diretório existente.

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

-Recursive

Lista manipula recursivamente. Só funciona no Diretório de Arquivos.

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

-ServerTimeoutPerRequest

O tempo limite do servidor para cada solicitação em segundos.

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

-Share

O objeto CloudFileShare indicava o compartilhamento onde os arquivos/diretórios seriam listados.

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

-ShareClient

O objeto ShareClient indicou o compartilhamento que contém os arquivos/diretórios a serem fechados.

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 que contém os arquivos/diretórios a serem fechados.

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

-ShareFileClient

O objeto ShareFileClient indicou o arquivo a ser fechado.

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

-ShareName

Nome do compartilhamento de arquivos onde os arquivos/diretórios seriam listados.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

CloudFileShare

CloudFileDirectory

IStorageContext

Saídas

CloseFileHandleResultSegment