New-AzRmStorageShare

Ссылка

Модуль:: Az.Storage

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

Синтаксис

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>]

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 proeprty в качестве 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 proeprty как NFS и RootSquash proeprty как 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
Допустимые значения:	TransactionOptimized, Premium, Hot, Cool
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

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

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultProfile

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

Тип:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnabledProtocol

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

Тип:	String
Допустимые значения:	NFS, SMB
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Metadata

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

Тип:	Hashtable
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Name

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

Тип:	String
Aliases:	N, ShareName
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PaidBurstingEnabled

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PaidBurstingMaxBandwidthMibps

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

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PaidBurstingMaxIops

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

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ProvisionedBandwidthMibps

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

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ProvisionedIops

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

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-QuotaGiB

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

Тип:	Int32
Aliases:	Quota
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ResourceGroupName

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

Тип:	String
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RootSquash

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

Тип:	String
Допустимые значения:	NoRootSquash, RootSquash, AllSquash
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Snapshot

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-StorageAccount

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

Тип:	PSStorageAccount
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-StorageAccountName

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

Тип:	String
Aliases:	AccountName
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

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

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

String

PSStorageAccount

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

PSShare

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