Partilhar via


Close-AzStorageFileHandle

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

Sintaxe

ShareNameCloseAll (Padrão)

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

ShareNameCloseSingle

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

ShareCloseAll

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

ShareCloseSingle

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

DirectoryCloseAll

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

FileCloseAll

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

Descrição

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

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

Exemplo 2: Feche todos os identificadores de arquivo que são 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 são abertos há 1 dia e, em seguida, 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 fechados

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

Este comando fecha todos os identificadores de arquivo em um diretório de arquivo 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

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

Parâmetros

-AsJob

Executar 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

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

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

-CloseAll

Força o fechamento de todas as alças de arquivo.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

ShareNameCloseAll
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
ShareCloseAll
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
DirectoryCloseAll
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
FileCloseAll
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ConcurrentTaskCount

A quantidade total de tarefas assíncronas simultâneas. 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:None
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

Objeto de contexto de armazenamento do Azure

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

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

-FileHandle

O identificador de arquivo para fechar.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-PassThru

Retornar a contagem de identificadores de arquivo fechados.

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

Caminho para um arquivo/diretório existente.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

ShareNameCloseAll
Posição:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
ShareCloseAll
Posição:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
DirectoryCloseAll
Posição:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Recursive

List manipula Recursivamente. Só funciona no Diretório de Arquivos.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-ServerTimeoutPerRequest

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

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 indicou o compartilhamento que contém os arquivos/diretórios para identificador fechado.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

ShareCloseAll
Posição:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False
ShareCloseSingle
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 indicou a pasta base que contém os arquivos/diretórios para o identificador fechado.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-ShareFileClient

O objeto ShareFileClient indicou o identificador de arquivo a ser fechado.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-ShareName

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

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

Tipo:SwitchParameter
Valor padrão:None
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

ShareFileClient

PSFileHandle

IStorageContext

Saídas

Int32