Close-AzStorageFileHandle
Schließt Dateihandles einer Dateifreigabe, eines Dateiverzeichnisses oder einer Datei.
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>]
Beschreibung
Das Cmdlet Close-AzStorageFileHandle schließt Dateihandles einer Dateifreigabe oder eines Dateiverzeichnisses oder einer Datei.
Beispiele
Beispiel 1: Schließen aller Dateihandles für eine Datei
Close-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2/test.txt' -CloseAll
Mit diesem Befehl werden alle Dateihandles für eine Datei geschlossen.
Beispiel 2: Schließen aller Dateihandles, die vor 1 Tag in einem Dateiverzeichnis geöffnet werden
Get-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2' -Recursive | Where-Object {$_.OpenTime.DateTime.AddDays(1) -lt (Get-Date)} | Close-AzStorageFileHandle -ShareName "mysharename"
Dieser Befehl listet alle Dateihandles in einem Dateiverzeichnis rekursiv auf, filtert die Handles heraus, die vor 1 Tagen geöffnet werden, und schließt sie dann.
Beispiel 3: Alle Dateihandles in einem Dateiverzeichnis rekursiv schließen und die Anzahl der geschlossenen Dateihandle anzeigen
Close-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2' -Recursive -CloseAll -PassThru
10
Mit diesem Befehl werden alle Dateihandles in einem Dateiverzeichnis geschlossen und die Anzahl der geschlossenen Dateihandles angezeigt.
Beispiel 4: Schließen aller Dateihandles auf einer Dateifreigabe
Close-AzStorageFileHandle -ShareName "mysharename" -CloseAll -Recursive
Mit diesem Befehl werden alle Dateihandles für eine bestimmte Dateifreigabe rekursiv geschlossen.
Parameter
-AsJob
Cmdlet im Hintergrund ausführen
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ClientTimeoutPerRequest
Die clientseitige maximale Ausführungszeit für jede Anforderung in Sekunden.
Typ: | Nullable<T>[Int32] |
Aliase: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-CloseAll
Erzwingen Sie das Schließen aller Dateihandles.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ConcurrentTaskCount
Die Gesamtmenge der gleichzeitigen asynchronen Vorgänge. Der Standardwert ist 10.
Typ: | Nullable<T>[Int32] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Context
Azure Storage Context-Objekt
Typ: | IStorageContext |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Typ: | IAzureContextContainer |
Aliase: | AzureRmContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Directory
Das CloudFileDirectory-Objekt hat den Basisordner angegeben, in dem die Dateien/Verzeichnisse aufgelistet werden.
Typ: | CloudFileDirectory |
Aliase: | CloudFileDirectory |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-DisAllowTrailingDot
Nicht zulassen, dass nachgestellter Punkt (.) verzeichnis- und Dateinamen suffixiert werden.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-File
Das CloudFile-Objekt hat die Datei zum Schließen des Handle angegeben.
Typ: | CloudFile |
Aliase: | CloudFile |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-FileHandle
Das zu schließende Dateihandle.
Typ: | PSFileHandle |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-PassThru
Gibt die Anzahl geschlossener Dateihandles zurück.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Path
Pfad zu einer vorhandenen Datei/einem vorhandenen Verzeichnis.
Typ: | String |
Position: | 1 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Recursive
Liste behandelt rekursiv. Funktioniert nur im Dateiverzeichnis.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ServerTimeoutPerRequest
Der Servertimeout für jede Anforderung in Sekunden.
Typ: | Nullable<T>[Int32] |
Aliase: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Share
Das CloudFileShare-Objekt hat die Freigabe angegeben, in der die Dateien/Verzeichnisse aufgelistet werden.
Typ: | CloudFileShare |
Aliase: | CloudFileShare |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ShareClient
Das ShareClient-Objekt hat die Freigabe angegeben, die die zu schließenden Dateien/Verzeichnisse enthält.
Typ: | ShareClient |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ShareDirectoryClient
Das ShareDirectoryClient-Objekt hat den Basisordner angegeben, der die zu schließenden Dateien/Verzeichnisse enthält.
Typ: | ShareDirectoryClient |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ShareFileClient
Das ShareFileClient-Objekt hat die Datei zum Schließen des Handle angegeben.
Typ: | ShareFileClient |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ShareName
Der Name der Dateifreigabe, in der die Dateien/Verzeichnisse aufgelistet werden.
Typ: | String |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |