Update-AzRmStorageShare

Модуль:: Az.Storage

Изменяет общую папку хранилища.

Синтаксис

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

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

Update-AzRmStorageShare
      [-ResourceId] <String>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzRmStorageShare
      -InputObject <PSShare>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

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

Примеры

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

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -QuotaGiB 200 -Metadata @{tag0="value0";tag1="value1"}

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

$share.Metadata

Key  Value  
---  ----- 
tag0 value0
tag1 value1

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

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

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount"
$share = Update-AzRmStorageShare -StorageAccount $accountObject -Name "myshare" -Metadata @{tag0="value0";tag1="value1"}

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

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

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | Update-AzRmStorageShare -QuotaGiB 5000

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
share1   5000
share2   5000

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

Пример 4. Изменение общей папки хранилища с помощью accesstier как Cool

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -AccessTier Cool

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

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

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

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -RootSquash NoRootSquash 

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

$share.RootSquash
NoRootSquash

Эта команда изменяет свойство RootSquash на NoRootSquash. Свойство RootSquash является только avaialbe для общего ресурса с EnabledProtocol как NFS.

Пример 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

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

Тип:	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

-InputObject

Объект Storage Share

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

-Metadata

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

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

-Name

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

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

-PaidBurstingEnabled

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

Тип:	Boolean
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

-ResourceId

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

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

-RootSquash

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

Тип:	String
Допустимые значения:	NoRootSquash, RootSquash, AllSquash
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

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