Share via


Remove-AzKeyVaultRoleDefinition

HSM에서 사용자 지정 역할 정의를 제거합니다.

Syntax

Remove-AzKeyVaultRoleDefinition
      [-HsmName] <String>
      [-Scope <String>]
      -RoleName <String>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzKeyVaultRoleDefinition
      [-HsmName] <String>
      [-Scope <String>]
      -InputObject <PSKeyVaultRoleDefinition>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

cmdlet은 Remove-AzKeyVaultRoleDefinition Azure KeyVault 관리형 HSM의 Azure 역할 기반 액세스 제어에서 사용자 지정 역할을 삭제합니다. -RoleName 기존 사용자 지정 역할 또는 역할 개체의 매개 변수를 제공하여 해당 사용자 지정 역할을 삭제합니다. 기본적으로 Remove-AzKeyVaultRoleDefinition 확인 메시지를 표시합니다. 프롬프트를 표시하지 않으면 매개 변수를 -Force 사용합니다.

예제

예 1

Remove-AzKeyVaultRoleDefinition -HsmName myHsm -RoleName "my role"

이 예제에서는 "내 역할"이라는 사용자 지정 역할을 제거합니다.

예제 2

$role = Get-AzKeyVaultRoleDefinition -HsmName myHsm -RoleName "my role"
$role | Remove-AzKeyVaultRoleDefinition -HsmName myHsm -Force

이 예제에서는 역할 개체를 파이핑하여 "내 역할"이라는 사용자 지정 역할을 제거합니다. 또한 다음을 통해 프롬프트 -Force를 표시하지 않습니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

확인을 요청하지 마십시오.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HsmName

HSM의 이름입니다.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

제거할 역할 정의를 나타내는 개체입니다.

Type:PSKeyVaultRoleDefinition
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

이 cmdlet은 기본적으로 개체를 반환하지 않습니다. 이 스위치를 지정하면 성공하면 true를 반환합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleName

가져올 역할 정의의 이름입니다.

Type:String
Aliases:RoleDefinitionName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Scope

역할 할당 또는 정의가 적용되는 범위(예: '/' 또는 '/keys' 또는 '/keys/{keyName}')입니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

PSKeyVaultRoleDefinition

출력

Boolean