Close-AzStorageFileHandle

Referência

Módulo:: Az.Storage

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

Sintaxe

Close-AzStorageFileHandle
     [-ShareName] <String>
     [[-Path] <String>]
     [-Recursive]
     [-CloseAll]
     [-DisAllowTrailingDot]
     [-PassThru]
     [-AsJob]
     [-Context <IStorageContext>]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Close-AzStorageFileHandle
     [-ShareName] <String>
     -FileHandle <PSFileHandle>
     [-DisAllowTrailingDot]
     [-PassThru]
     [-AsJob]
     [-Context <IStorageContext>]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Close-AzStorageFileHandle
     [-ShareClient] <ShareClient>
     [[-Path] <String>]
     [-Recursive]
     [-CloseAll]
     [-PassThru]
     [-AsJob]
     [-Context <IStorageContext>]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Close-AzStorageFileHandle
     [-ShareClient] <ShareClient>
     -FileHandle <PSFileHandle>
     [-PassThru]
     [-AsJob]
     [-Context <IStorageContext>]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Close-AzStorageFileHandle
     [-ShareDirectoryClient] <ShareDirectoryClient>
     [[-Path] <String>]
     [-Recursive]
     [-CloseAll]
     [-PassThru]
     [-AsJob]
     [-Context <IStorageContext>]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Close-AzStorageFileHandle
     [-ShareFileClient] <ShareFileClient>
     [-CloseAll]
     [-PassThru]
     [-AsJob]
     [-Context <IStorageContext>]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

O cmdlet Close-AzStorageFileHandle fecha os identificadores de arquivo de um compartilhamento de arquivo, ou diretório de arquivo 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: fechar todos os identificadores de arquivo abertos há um dia em um diretório de arquivo

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

Esse comando lista todos os identificadores de arquivo em um diretório de arquivos recursivamente, filtra os identificadores abertos há um dia e os fecha.

Exemplo 3: feche todos os identificadores de arquivo em um diretório de arquivos recursivamente e mostre a contagem de identificadores de arquivo fechado

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

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ClientTimeoutPerRequest

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

Tipo:	Nullable<T>[Int32]
Aliases:	ClientTimeoutPerRequestInSeconds
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CloseAll

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

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ConcurrentTaskCount

A quantidade total de tarefas assíncronas simultâneas. O valor padrão é 10.

Tipo:	Nullable<T>[Int32]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Context

Objeto de contexto de armazenamento do Azure

Tipo:	IStorageContext
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-DefaultProfile

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

Tipo:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisAllowTrailingDot

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

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-FileHandle

O Identificador de Arquivo a ser fechado.

Tipo:	PSFileHandle
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-PassThru

Retorne a contagem de identificadores de arquivo fechados.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Path

Caminho para um arquivo/diretório existente.

Tipo:	String
Cargo:	1
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Recursive

A lista manipula recursivamente. Só funciona no Diretório de Arquivos.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ServerTimeoutPerRequest

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

Tipo:	Nullable<T>[Int32]
Aliases:	ServerTimeoutPerRequestInSeconds
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ShareClient

O objeto ShareClient indicou o compartilhamento que contém os arquivos/diretórios para o identificador fechado.

Tipo:	ShareClient
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-ShareDirectoryClient

O objeto ShareDirectoryClient indicou a pasta base que contém os arquivos/diretórios para o identificador fechado.

Tipo:	ShareDirectoryClient
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-ShareFileClient

O objeto ShareFileClient indicou o arquivo para fechar o identificador.

Tipo:	ShareFileClient
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-ShareName

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

Tipo:	String
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

ShareClient

ShareDirectoryClient

ShareFileClient

PSFileHandle

IStorageContext

Saídas

Int32

Compartilhar via