Update-AzRmStorageShare
Изменяет общую папку хранилища.
Синтаксис
AccountName (по умолчанию)
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>]
AccountObject
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>]
ShareResourceId
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>]
ShareObject
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 доступно только для общего ресурса с 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
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
Объект Storage Share
Тип: PSShare
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Поделиться
ShareObject
Position: Named
Обязательно: True
Значение из конвейера: True
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
Общий доступ к метаданным
Тип: Hashtable
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Name
Имя общего ресурса
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: N, ShareName
Наборы параметров
AccountName
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AccountObject
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-PaidBurstingEnabled
Указывает, включена ли платная вспышка для общей папки. Это свойство предназначено только для общих папок, созданных в разделе "Подготовленные файлы", тип учетной записи SSD версии 1.
Свойства параметра
Тип: Boolean
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
-ResourceId
Введите идентификатор ресурса общей папки.
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
ShareResourceId
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-RootSquash
Задает сокращение прав доступа для удаленного суперпользователя. Возможные значения: NoRootSquash, RootSquash, AllSquash
Свойства параметра
Тип: String
Default value: None
Допустимые значения: NoRootSquash, RootSquash, AllSquash
Поддерживаются подстановочные знаки: 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 .
Выходные данные