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

New-AzRmStorageShare

Модуль:
Az.Storage Module

Создает общую папку хранилища.

Синтаксис

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

New-AzRmStorageShare
    [-ResourceGroupName] <String>
    [-StorageAccountName] <String>
    -Name <String>
    [-QuotaGiB <Int32>]
    [-Metadata <Hashtable>]
    [-AccessTier <String>]
    [-Snapshot]
    [-EnabledProtocol <String>]
    [-RootSquash <String>]
    [-ProvisionedBandwidthMibps <Int32>]
    [-ProvisionedIops <Int32>]
    [-PaidBurstingEnabled]
    [-PaidBurstingMaxIops <Int32>]
    [-PaidBurstingMaxBandwidthMibps <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AccountObject 

New-AzRmStorageShare
    -StorageAccount <PSStorageAccount>
    -Name <String>
    [-QuotaGiB <Int32>]
    [-Metadata <Hashtable>]
    [-AccessTier <String>]
    [-Snapshot]
    [-EnabledProtocol <String>]
    [-RootSquash <String>]
    [-ProvisionedBandwidthMibps <Int32>]
    [-ProvisionedIops <Int32>]
    [-PaidBurstingEnabled]
    [-PaidBurstingMaxIops <Int32>]
    [-PaidBurstingMaxBandwidthMibps <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет New-AzRmStorageShare создает общую папку хранилища.

Примеры

Пример 1. Создание общей папки хранилища с именем учетной записи хранения и именем общего ресурса с метаданными и квотой общего ресурса как 100 ГиБ.

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -QuotaGiB 100 -Metadata @{"tag1" = "value1"; "tag2" = "value2" }

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocol AccessTier Deleted Version ShareUsageBytes
----     -------- --------------- ---------- ------- ------- ---------------
myshare

Эта команда создает общую папку хранилища с метаданными и квотой общего ресурса как 100 ГиБ.

Пример 2. Создание общей папки хранилища с помощью объекта учетной записи хранения

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocol AccessTier Deleted Version ShareUsageBytes
----     -------- --------------- ---------- ------- ------- ---------------
myshare

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

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

$share = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -AccessTier Hot

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

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

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

$shareSnapshot = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -Snapshot

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes snapshotTime
----     -------- ---------------- ---------- ------- ------- --------------- ------------
myshare                                                                       2021-05-10T08:04:08

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

Пример 5. Создание общей папки хранилища с свойством EnabledProtocol как NFS и rootSquash как NoRootSquash

$share = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -EnabledProtocol NFS -RootSquash NoRootSquash

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

$share.RootSquash
NoRootSquash

Эта команда создает общую папку хранилища с свойством EnabledProtocol как NFS и RootSquash как NoRootSquash.

Пример 6. Создание общей папки хранилища с подготовленной пропускной способностью и операций ввода-вывода в секунду

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -ProvisionedBandwidthMibps 129 -ProvisionedIops 3032

Эта команда создает общую папку хранилища с подготовленной пропускной способностью и операций ввода-вывода в секунду, она работает только с типом учетной записи подготовки файлов версии 2.

Пример 7. Создание общей папки хранилища с платной пропускной способностью и операций ввода-вывода в секунду

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -PaidBurstingEnabled -PaidBurstingMaxBandwidthMibps 129 -PaidBurstingMaxIops 3032

Эта команда создает общую папку хранилища с платной пропускной способностью и операций ввода-вывода в секунду, она работает только с типом учетной записи подготовки файлов версии 1.

Параметры

-AccessTier

Уровень доступа для определенной общей папки. Учетная запись StorageV2 может выбирать между TransactionOptimized (по умолчанию), горячей и холодной. Учетная запись FileStorage может выбрать Premium.

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

Тип:String
Default value:None
Допустимые значения:TransactionOptimized, Premium, Hot, Cool
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

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

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

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

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

-DefaultProfile

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

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

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

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

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

-EnabledProtocol

Задает протоколы для общих папок. Его нельзя изменить после создания общей папки. Возможные значения: "SMB", "NFS"

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

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

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

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

-Metadata

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

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

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

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

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

-Name

Имя общей папки Azure

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

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

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

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

-PaidBurstingEnabled

Указывает, включена ли платная вспышка для общей папки. Это свойство предназначено только для общих папок, созданных в разделе "Подготовленные файлы", тип учетной записи SSD версии 1.

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

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

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

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

-PaidBurstingMaxBandwidthMibps

Максимальная платная пропускная способность для общей папки в мебибайтах в секунду. Это свойство предназначено только для общих папок, созданных в разделе "Подготовленные файлы", тип учетной записи SSD версии 1. Максимально допустимое значение — 10340, которое является максимально допустимой пропускной способностью для общей папки.

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

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

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

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

-PaidBurstingMaxIops

Максимальное количество платных операций ввода-вывода в секунду для общей папки. Это свойство предназначено только для общих папок, созданных в разделе "Подготовленные файлы", тип учетной записи SSD версии 1. Максимально допустимое значение — 102400, которое является максимальным допустимым числом операций ввода-вывода в секунду для общей папки.

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

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

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

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

-ProvisionedBandwidthMibps

Подготовленная пропускная способность общей папки в мбибайтах в секунду. Это свойство предназначено только для общих папок, созданных в разделе "Подготовленные файлы" версии 2. Обратитесь к выходным данным командлета Get-AzStorageFileServiceUsage для минимального и максимального допустимого значения подготовленной пропускной способности.

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

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

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

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

-ProvisionedIops

Подготовленные операции ввода-вывода в секунду общего ресурса. Это свойство предназначено только для общих папок, созданных в разделе "Подготовленные файлы" версии 2. Обратитесь к выходным данным командлета Get-AzStorageFileServiceUsage минимальное и максимально допустимое значение для подготовленных операций ввода-вывода в секунду.

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

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

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

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

-QuotaGiB

Общий доступ к квоте в Gibibyte.

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

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

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

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

-ResourceGroupName

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

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

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

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

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

-RootSquash

Задает сокращение прав доступа для удаленного суперпользователя. Возможные значения: NoRootSquash, RootSquash, AllSquash

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

Тип:String
Default value:None
Допустимые значения:NoRootSquash, RootSquash, AllSquash
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Snapshot

Создайте моментальный снимок существующей общей папки с тем же именем.

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

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

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

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

-StorageAccount

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

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

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

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

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

-StorageAccountName

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

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

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

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

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

-WhatIf

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

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

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

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

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

CommonParameters

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

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

String

PSStorageAccount

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

PSShare