Get-AzStorageFile

  • Ссылка
Модуль:
Az.Storage

Перечисляет каталоги и файлы для пути.

Синтаксис

Get-AzStorageFile
   [-ShareName] <String>
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageFile
   [-Share] <CloudFileShare>
   [-ShareClient <ShareClient>]
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageFile
   [-Directory] <CloudFileDirectory>
   [-ShareDirectoryClient <ShareDirectoryClient>]
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Описание

Командлет Get-Az служба хранилища File содержит каталоги и файлы для указанного общего ресурса или каталога. Укажите параметр Path, чтобы получить экземпляр каталога или файла в указанном пути. Этот командлет возвращает объекты Azure служба хранилища File и Azure служба хранилища Directory. Свойство IsDirectory можно использовать для различения папок и файлов.

Примеры

Пример 1. Перечисление каталогов в общей папке

Get-AzStorageFile -ShareName "ContosoShare06" | Where-Object {$_.GetType().Name -eq "AzureStorageFileDirectory"}

Эта команда содержит только каталоги в общей папке ContosoShare06. Сначала он извлекает файлы и каталоги, передает их в оператор where с помощью оператора конвейера, а затем отключает карта все объекты, тип которых не является "Azure служба хранилища FileDirectory".

Пример 2. Перечисление каталога файлов

Get-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzStorageFile

Эта команда содержит файлы и папки в каталоге ContosoWorkingFolder в общей папке ContosoShare06. Сначала он получает экземпляр каталога, а затем конвейерирует его в командлет Get-Az служба хранилища File для перечисления каталога.

Параметры

-ClientTimeoutPerRequest

Указывает интервал времени ожидания на стороне клиента (в секундах) для одного запроса на обслуживание. Если предыдущий вызов завершается сбоем в течение указанного интервала, этот командлет повторяет запрос. Если этот командлет не получает успешный ответ до истечения интервала, этот командлет возвращает ошибку.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

Указывает максимальное число одновременных сетевых вызовов. Этот параметр можно использовать для ограничения параллелизма для регулирования использования локального ЦП и пропускной способности, указав максимальное количество одновременных сетевых вызовов. Указанное значение является абсолютным числом и не умножается на число ядер. Этот параметр может помочь устранить проблемы с сетевым подключением в средах с низкой пропускной способностью, например 100 килобит в секунду. Значение по умолчанию — 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Указывает контекст служба хранилища Azure. Чтобы получить контекст служба хранилища, используйте командлет New-Az служба хранилища Context.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Directory

Указывает папку как объект CloudFileDirectory . Этот командлет получает папку, указанную этим параметром. Чтобы получить каталог, используйте командлет New-Az служба хранилища Directory. Для получения каталога можно также использовать командлет Get-Az служба хранилища File.

Type:CloudFileDirectory
Aliases:CloudFileDirectory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DisAllowTrailingDot

Запретить конечные точки (.) для суффикса каталогов и имен файлов.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeExtendedInfo

Не включать расширенные сведения о файлах, таких как метки времени, ETag, атрибуты, разрешенияKey в файле списка и каталоге.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Указывает путь к папке. Если параметр Path не указан, Get-Az служба хранилища File выводит каталоги и файлы в указанной общей папке или каталоге. Если включить параметр Path, Get-Az служба хранилища File возвращает экземпляр каталога или файла в указанном пути.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Указывает интервал времени ожидания на стороне службы (в секундах) для запроса. Если указанный интервал истекает до обработки запроса службой, служба служба хранилища возвращает ошибку.

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Share

Указывает объект CloudFileShare . Этот командлет получает файл или каталог из общей папки, указанной этим параметром. Чтобы получить объект CloudFileShare, используйте командлет Get-Az служба хранилища Share. Этот объект содержит контекст служба хранилища. Если этот параметр указан, не указывайте параметр Context .

Type:CloudFileShare
Aliases:CloudFileShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareClient

Объект ShareClient указывает общую папку, в которой будут перечислены файлы и каталоги.

Type:ShareClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareDirectoryClient

Объект ShareDirectoryClient указывает базовую папку, в которой будут перечислены файлы и каталоги.

Type:ShareDirectoryClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareName

Указывает имя общей папки. Этот командлет получает файл или каталог из общей папки, указанной этим параметром.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

CloudFileShare

CloudFileDirectory

IStorageContext

Выходные данные

AzureStorageFile