Compartir a través de


Get-AzStorageFileHandle

Enumera los identificadores de archivo de un recurso compartido de archivos, un directorio de archivos o un archivo.

Sintaxis

Get-AzStorageFileHandle
   [-ShareName] <String>
   [[-Path] <String>]
   [-Recursive]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzStorageFileHandle
   [-Share] <CloudFileShare>
   [-ShareClient <ShareClient>]
   [[-Path] <String>]
   [-Recursive]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzStorageFileHandle
   [-Directory] <CloudFileDirectory>
   [-ShareDirectoryClient <ShareDirectoryClient>]
   [[-Path] <String>]
   [-Recursive]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzStorageFileHandle
   [-File] <CloudFile>
   [-ShareFileClient <ShareFileClient>]
   [-Recursive]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]

Description

El cmdlet Get-AzStorageFileHandle enumera los identificadores de archivo de un recurso compartido de archivos, un directorio de archivos o un archivo.

Ejemplos

Ejemplo 1: Se enumeran todos los identificadores de archivo de un recurso compartido de archivos de forma recursiva y ordénelos por IP y OpenTime.

Get-AzStorageFileHandle -ShareName "mysharename" -Recursive | Sort-Object ClientIP,OpenTime

HandleId    Path                  ClientIp       ClientPort OpenTime             LastReconnectTime FileId               ParentId             SessionId          
--------    ----                  --------       ---------- --------             ----------------- ------               --------             ---------          
28506980357                       104.46.105.229 49805      2019-07-29 08:37:36Z                   0                    0                    9297571480349046273
28506980537 dir1                  104.46.105.229 49805      2019-07-30 09:28:48Z                   10376363910205800448 0                    9297571480349046273
28506980538 dir1                  104.46.105.229 49805      2019-07-30 09:28:48Z                   10376363910205800448 0                    9297571480349046273
28582543365                       104.46.119.170 51675      2019-07-30 09:29:32Z                   0                    0                    9477733061320772929
28582543375 dir1                  104.46.119.170 51675      2019-07-30 09:29:38Z                   10376363910205800448 0                    9477733061320772929
28582543376 dir1                  104.46.119.170 51675      2019-07-30 09:29:38Z                   10376363910205800448 0                    9477733061320772929

Este comando enumera los identificadores de archivo en un recurso compartido de archivos y ordena la salida por ClientIp y, a continuación, por OpenTime.

Ejemplo 2: Se enumeran los dos primeros identificadores de archivo en un directorio de archivos de forma recursiva.

Get-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2'  -Recursive -First 2

HandleId    Path      ClientIp       ClientPort OpenTime             LastReconnectTime FileId               ParentId             SessionId          
--------    ----      --------       ---------- --------             ----------------- ------               --------             ---------          
24057151779 dir1/dir2 104.46.105.229 50861      2019-06-18 07:39:23Z                   16140971433240035328 11529285414812647424 9549812641162070049
24057151780 dir1/dir2 104.46.105.229 50861      2019-06-18 07:39:23Z                   16140971433240035328 11529285414812647424 9549812641162070049

Este comando enumera los 2 primeros identificadores de archivo en un directorio de archivos de forma recursiva.

Ejemplo 3: Enumeración del 3º a los identificadores de archivo 6 en un archivo

Get-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2/test.txt' -skip 2 -First 4

HandleId    Path               ClientIp       ClientPort OpenTime             LastReconnectTime FileId              ParentId             SessionId          
--------    ----               --------       ---------- --------             ----------------- ------              --------             ---------          
24055513248 dir1/dir2/test.txt 104.46.105.229 49817      2019-06-18 08:21:59Z                   9223407221226864640 16140971433240035328 9338416139169958321
24055513249 dir1/dir2/test.txt 104.46.105.229 49817      2019-06-18 08:21:59Z                   9223407221226864640 16140971433240035328 9338416139169958321
24055513252 dir1/dir2/test.txt 104.46.105.229 49964      2019-06-18 08:22:54Z                   9223407221226864640 16140971433240035328 9338416138431762125
24055513253 dir1/dir2/test.txt 104.46.105.229 49964      2019-06-18 08:22:54Z                   9223407221226864640 16140971433240035328 9338416138431762125

Este comando muestra el 3º a los identificadores de archivo 6 en un archivo.

Parámetros

-ClientTimeoutPerRequest

Tiempo máximo de ejecución del lado cliente para cada solicitud en segundos.

Tipo:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ConcurrentTaskCount

Cantidad total de tareas asincrónicas simultáneas. El valor predeterminado es 10.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Context

Objeto de contexto de Azure Storage

Tipo:IStorageContext
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Directory

El objeto CloudFileDirectory indicó la carpeta base donde se enumerarían los archivos o directorios.

Tipo:CloudFileDirectory
Alias:CloudFileDirectory
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DisAllowTrailingDot

No permitir el punto final (.) al directorio de sufijo y los nombres de archivo.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-File

El objeto CloudFile indicó el archivo para enumerar identificadores de archivo.

Tipo:CloudFile
Alias:CloudFile
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-First

Obtiene solo los primeros objetos 'n'.

Tipo:UInt64
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IncludeTotalCount

Informa del número de objetos del conjunto de datos (un entero) seguido de los objetos . Si el cmdlet no puede determinar el recuento total, devuelve "Recuento total desconocido". Actualmente, este parámetro no hace nada.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Path

Ruta de acceso a un archivo o directorio existente.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Recursive

Enumera los identificadores recursivos. Solo funciona en el directorio de archivos.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServerTimeoutPerRequest

Tiempo de espera del servidor para cada solicitud en segundos.

Tipo:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Share

El objeto CloudFileShare indicó el recurso compartido donde se enumerarían los archivos o directorios.

Tipo:CloudFileShare
Alias:CloudFileShare
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ShareClient

El objeto ShareClient indicó el recurso compartido en el que los archivos o directorios enumerarían los identificadores de archivo.

Tipo:ShareClient
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ShareDirectoryClient

El objeto ShareDirectoryClient indicó la carpeta base donde los archivos o directorios enumerarían los identificadores de archivo.

Tipo:ShareDirectoryClient
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ShareFileClient

El objeto ShareFileClient indicó el archivo para enumerar identificadores de archivo.

Tipo:ShareFileClient
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ShareName

Nombre del recurso compartido de archivos donde se enumerarían los archivos o directorios.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Skip

Omite los primeros objetos 'n' y, a continuación, obtiene los objetos restantes.

Tipo:UInt64
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

CloudFileShare

CloudFileDirectory

IStorageContext

Salidas

FileHandleResultSegment