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


Remove-AzRmStorageShare

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

Синтаксис

Remove-AzRmStorageShare
      [-ResourceGroupName] <String>
      [-StorageAccountName] <String>
      -Name <String>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzRmStorageShare
      [-ResourceGroupName] <String>
      [-StorageAccountName] <String>
      -Name <String>
      -SnapshotTime <DateTime>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzRmStorageShare
      -Name <String>
      -StorageAccount <PSStorageAccount>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzRmStorageShare
      -Name <String>
      -StorageAccount <PSStorageAccount>
      -SnapshotTime <DateTime>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzRmStorageShare
      [-ResourceId] <String>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzRmStorageShare
      -InputObject <PSShare>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

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

Примеры

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

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare"

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

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

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount"
Remove-AzRmStorageShare -StorageAccount $accountObject -Name "myshare"

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

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

Get-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" | Remove-AzRmStorageShare -Force

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

Пример 4. Удаление одного моментального снимка файлового ресурса хранилища

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -SnapshotTime "2021-05-10T08:04:08Z"

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

Пример 5. Удаление общей папки хранилища и моментальных снимков

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -Include Snapshots

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

Пример 6. Удаление общей папки хранилища и всех моментальных снимков (включая арендованные моментальные снимки)

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -Include Leased-Snapshots

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

Параметры

-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

-Force

Принудительно удалить общий доступ (моментальный снимок) и все содержимое в нем

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

-Include

Допустимые значения: моментальные снимки, арендованные моментальные снимки, нет. Значение по умолчанию — нет. Если у него нет моментальных снимков общих папок, общий файловый ресурс удаляется. Если общая папка содержит любые моментальные снимки (арендованные или неуправляемые), удаление завершается ошибкой. Для моментальных снимков общий файловый ресурс удаляется, включая все его моментальные снимки общей папки. Если общая папка содержит арендованные моментальные снимки, удаление завершается ошибкой. Для "арендованных моментальных снимков" общий файловый ресурс удаляется во всех его моментальных снимках общей папки (арендованных или неуправляемых).

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

-InputObject

Объект Storage Share

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

-Name

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

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

-PassThru

Указывает, что этот командлет возвращает логическое значение, которое отражает успешность операции. По умолчанию этот командлет не возвращает значение.

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

-SnapshotTime

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

Тип:Nullable<T>[DateTime]
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера: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

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

Boolean