Share via

Get-AzStorageShare

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

Возвращает список общих папок.

Синтаксис

Get-AzStorageShare
   [[-Prefix] <String>]
   [-IncludeDeleted]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageShare
   [-Name] <String>
   [[-SnapshotTime] <DateTimeOffset>]
   [-SkipGetProperty]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Описание

Командлет Get-Az служба хранилища Share получает список общих папок для учетной записи хранения.

Примеры

Пример 1. Получение общей папки

Get-AzStorageShare -Name "ContosoShare06"

Эта команда получает общую папку ContosoShare06.

Пример 2. Получение всех общих папок, начинающихся со строки

Get-AzStorageShare -Prefix "Contoso"

Эта команда получает все общие папки с именами, начинающимися с Contoso.

Пример 3. Получение всех общих папок в указанном контексте

$Context = New-AzStorageContext -Local
Get-AzStorageShare -Context $Context

Первая команда использует командлет New-Az служба хранилища Context для создания контекста с помощью локального параметра, а затем сохраняет этот объект контекста в переменной $Context. Вторая команда получает общие папки для объекта контекста, хранящегося в $Context.

Пример 4. Получение моментального снимка общей папки с определенным именем общего ресурса и SnapshotTime

Get-AzStorageShare -Name "ContosoShare06" -SnapshotTime "6/16/2017 9:48:41 AM +00:00"

Эта команда получает моментальный снимок общей папки с определенным именем общего ресурса и SnapshotTime.

Пример 5. Получение объекта общей папки без получения свойств общего ресурса с проверкой подлинности OAuth.

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent
$share = Get-AzStorageShare -Name "ContosoShare06" -SkipGetProperty -Context $ctx

Эта команда получает моментальный снимок общей папки без получения свойств общего ресурса с проверкой подлинности OAuth. Получение свойств общего ресурса с проверкой подлинности OAuth завершится ошибкой, так как API не поддерживает OAuth. Таким образом, чтобы получить объект общего доступа с проверкой подлинности OAuth, необходимо пропустить свойства общего ресурса.

Параметры

-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

-IncludeDeleted

Включение удаленных общих папок по умолчанию не будет включать удаленные общие папки

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

-Name

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

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

-Prefix

Задает префикс для общих папок. Этот командлет получает общие папки, соответствующие префиксу, указанному параметру, или нет общих папок, если общие папки не соответствуют указанному префиксу.

Type:String
Position:0
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

-SkipGetProperty

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

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

-SnapshotTime

Моментальный снимок моментального снимка общей папки, который требуется получить.

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

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

IStorageContext

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

AzureStorageFileShare