Partager via


Close-AzStorageFileHandle

Ferme les handles de fichiers d’un partage de fichiers, d’un répertoire de fichiers ou d’un fichier.

Syntaxe

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

L’applet de commande Close-AzStorageFileHandle ferme les handles de fichier d’un partage de fichiers, ou le répertoire de fichiers ou un fichier.

Exemples

Exemple 1 : Fermer tous les handles de fichier sur un fichier

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

Cette commande ferme tous les handles de fichier sur un fichier.

Exemple 2 : Fermer tous les handles de fichiers ouverts il y a 1 jour sur un répertoire de fichiers

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

Cette commande répertorie tous les handles de fichiers d’un répertoire de fichiers de manière récursive, filtre les handles qui sont ouverts il y a 1 jour, puis les ferme.

Exemple 3 : Fermer tous les handles de fichier d’un répertoire de fichiers de manière récursive et afficher le nombre de handles de fichier fermés

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

10

Cette commande ferme tous les handles de fichiers dans un répertoire de fichiers et affiche le nombre de handles de fichiers fermés.

Exemple 4 : Fermer tous les handles de fichier sur un partage de fichiers

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

Cette commande ferme tous les handles de fichiers sur un partage de fichiers spécifique de manière récursive.

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ClientTimeoutPerRequest

Durée d’exécution maximale côté client pour chaque requête en secondes.

Type:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CloseAll

Forcez la fermeture de tous les handles de fichier.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ConcurrentTaskCount

Quantité totale de tâches asynchrones simultanées. La valeur par défaut est 10.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Context

objet de contexte Stockage Azure

Type:IStorageContext
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Directory

L’objet CloudFileDirectory indique le dossier de base dans lequel les fichiers/répertoires sont répertoriés.

Type:CloudFileDirectory
Alias:CloudFileDirectory
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DisAllowTrailingDot

Interdire le point de fin (.) au répertoire de suffixe et aux noms de fichiers.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-File

L’objet CloudFile indique le fichier pour fermer le handle.

Type:CloudFile
Alias:CloudFile
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-FileHandle

Handle de fichier à fermer.

Type:PSFileHandle
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Retourne le nombre de handles de fichiers fermés.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Chemin d’accès à un fichier/répertoire existant.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Recursive

La liste gère de manière récursive. Fonctionne uniquement sur le répertoire de fichiers.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServerTimeoutPerRequest

Délai d’expiration du serveur pour chaque requête en secondes.

Type:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Share

L’objet CloudFileShare indique le partage dans lequel les fichiers/répertoires sont répertoriés.

Type:CloudFileShare
Alias:CloudFileShare
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ShareClient

L’objet ShareClient indique le partage qui contient les fichiers/répertoires à gérer fermés.

Type:ShareClient
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ShareDirectoryClient

L’objet ShareDirectoryClient indique le dossier de base qui contient les fichiers/répertoires à gérer fermés.

Type:ShareDirectoryClient
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ShareFileClient

L’objet ShareFileClient indique le fichier pour fermer le handle.

Type:ShareFileClient
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ShareName

Nom du partage de fichiers dans lequel les fichiers/répertoires sont répertoriés.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

CloudFileShare

CloudFileDirectory

IStorageContext

Sorties

CloseFileHandleResultSegment