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


Remove-AzureRmRoleDefinition

Удаляет пользовательскую роль в Azure RBAC. Роль для удаления указывается с помощью свойства Идентификатора роли. Удаление завершится ошибкой, если существуют существующие назначения ролей, сделанные в настраиваемую роль.

Предупреждение

Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

Remove-AzureRmRoleDefinition
      -Id <Guid>
      [-Scope <String>]
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmRoleDefinition
      [-Name] <String>
      [-Scope <String>]
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmRoleDefinition
      -InputObject <PSRoleDefinition>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Remove-AzureRmRoleDefinition удаляет пользовательскую роль в контроль доступа на основе ролей Azure. Укажите параметр id существующей настраиваемой роли для удаления этой настраиваемой роли. По умолчанию Remove-AzureRmRoleDefinition запрашивает подтверждение. Чтобы отключить запрос, используйте параметр Force. При наличии существующих назначений ролей, сделанных для удаления настраиваемой роли, удаление завершится ошибкой.

Примеры

Пример 1

Get-AzureRmRoleDefinition -Name "Virtual Machine Operator" | Remove-AzureRmRoleDefinition

Пример 2

Remove-AzureRmRoleDefinition -Id "52a6cc13-ff92-47a8-a39b-2a8205c3087e"

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Тип:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Если задано, не запрашивает подтверждение перед удалением настраиваемой роли.

Тип:SwitchParameter
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Идентификатор определения роли для удаления

Тип:Guid
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

Объект, представляющий определение роли для удаления.

Тип:PSRoleDefinition
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Имя определения роли, который необходимо удалить.

Тип:String
Position:0
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Тип:SwitchParameter
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Определение роли область.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Тип:SwitchParameter
Aliases:wi
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

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

Guid

String

PSRoleDefinition

Параметры: InputObject (ByValue)

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

Boolean

Примечания

Ключевые слова: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment