Поделиться через


Get-AzRmStorageShare

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

Синтаксис

AccountNameSingle (по умолчанию)

Get-AzRmStorageShare
    [-ResourceGroupName] <String>
    [-StorageAccountName] <String>
    [-Name <String>]
    [-SnapshotTime <DateTime>]
    [-GetShareUsage]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

AccountName

Get-AzRmStorageShare
    [-ResourceGroupName] <String>
    [-StorageAccountName] <String>
    [-IncludeDeleted]
    [-IncludeSnapshot]
    [-Filter <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

AccountObjectSingle

Get-AzRmStorageShare
    -StorageAccount <PSStorageAccount>
    -Name <String>
    [-SnapshotTime <DateTime>]
    [-GetShareUsage]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

AccountObject

Get-AzRmStorageShare
    -StorageAccount <PSStorageAccount>
    [-IncludeDeleted]
    [-IncludeSnapshot]
    [-Filter <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ShareResourceId

Get-AzRmStorageShare
    [-ResourceId] <String>
    [-GetShareUsage]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Описание

Командлет Get-AzRmStorageShare получает или перечисляет общие папки хранилища.

Примеры

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

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare"
ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  5120

Эта команда получает общую папку хранилища с именем учетной записи хранения и именем общего ресурса.

Пример 2. Вывод списка всех общих папок хранилища учетной записи хранения

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount"
ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier           Deleted Version ShareUsageBytes
----     -------- ---------------- ----------           ------- ------- ---------------
share1   5120                     TransactionOptimized
share2   5120                     TransactionOptimized

Эта команда содержит список всех общих папок хранилища учетной записи хранения с именем учетной записи хранения.

Пример 3. Получение контейнера BLOB-объектов хранилища с помощью объекта учетной записи хранения и имени контейнера.

Get-AzStorageAccount -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | Get-AzRmStorageShare -Name "myshare"
ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  5120

Эта команда получает контейнер BLOB-объектов хранилища с объектом учетной записи хранения и именем контейнера.

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

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -GetShareUsage
ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  5120                                                2097152

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

Пример 5. Перечисление всех общих папок хранилища учетной записи хранения, включение удаленных общих папок, создание моментальных снимков общих папок

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -IncludeDeleted -IncludeSnapshot
ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name       QuotaGiB EnabledProtocols AccessTier           Deleted Version          ShareUsageBytes snapshotTime
----       -------- ---------------- ----------           ------- -------          --------------- ------------
testshare1 5120                     TransactionOptimized                                          2021-05-10T08:04:08Z
testshare1 5120                     TransactionOptimized
share1     100                      TransactionOptimized True    01D61FD1FC5498B6

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

Пример 6. Получение одного моментального снимка общего ресурса

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "testshare1" -SnapshotTime "2021-05-10T08:04:08Z"
ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name       QuotaGiB EnabledProtocols AccessTier           Deleted Version ShareUsageBytes snapshotTime
----       -------- ---------------- ----------           ------- ------- --------------- ------------
testshare1 5120                     TransactionOptimized                                 2021-05-10T08:04:08Z

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

Пример 7. Вывод списка общих папок хранилища учетной записи хранения с фильтром

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Filter "startswith(name, test)"
ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name       QuotaGiB EnabledProtocols AccessTier           Deleted Version ShareUsageBytes snapshotTime
----       -------- ---------------- ----------           ------- ------- --------------- ------------
testshare1 5120     SMB              TransactionOptimized
testshare2 5120     SMB              TransactionOptimized

Эта команда содержит список всех общих папок хранилища с именами, начинающимися с "test".

Параметры

-DefaultProfile

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

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Filter

Фильтр имени общей папки. При указании будут перечислены только имена общих файлов, начиная с фильтра. Фильтр должен быть в формате: startswith(name, <prefix>)

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

AccountName
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
AccountObject
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-GetShareUsage

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

AccountNameSingle
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
AccountObjectSingle
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ShareResourceId
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IncludeDeleted

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

AccountName
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
AccountObject
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IncludeSnapshot

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

AccountName
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
AccountObject
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Имя общего ресурса

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:N, ShareName

Наборы параметров

AccountNameSingle
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ResourceGroupName

Имя группы ресурсов.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

AccountNameSingle
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
AccountName
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ResourceId

Введите идентификатор ресурса общей папки.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ShareResourceId
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-SnapshotTime

Общий доступ к моментальному снимку

Свойства параметра

Тип:

Nullable<T>[DateTime]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

AccountNameSingle
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
AccountObjectSingle
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-StorageAccount

Объект учетной записи хранения

Свойства параметра

Тип:PSStorageAccount
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

AccountObjectSingle
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
AccountObject
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-StorageAccountName

Имя учетной записи хранения.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Название аккаунта

Наборы параметров

AccountNameSingle
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
AccountName
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

PSStorageAccount

String

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

PSShare