Remove-CMSecurityRole
사용자 지정 보안 역할을 제거합니다.
구문
Remove-CMSecurityRole
[-Force]
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMSecurityRole
[-Force]
-Id <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMSecurityRole
[-Force]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
이 cmdlet을 사용하여 Configuration Manager에서 사용자 지정 보안 역할을 제거합니다. 제거하려는 보안 역할의 이름 또는 ID를 지정하거나 Get-CMSecurityRole cmdlet을 사용하여 가져옵니다.
Remove-CMSecurityRole cmdlet을 사용하여 불필요한 이전 사용자 지정 보안 역할을 제거할 수 있습니다. 기본 제공 보안 역할은 제거할 수 없습니다. 모든 관리 사용자에게는 하나 이상의 보안 역할이 있어야 합니다. 보안 역할을 제거하기 전에 모든 사용자에게 제거한 역할 외에 역할이 있는지 확인합니다.
보안 역할 및 권한에 대한 자세한 내용은 Configuration Manager에서 역할 기반 관리의 기본 사항을 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>
). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 이름을 사용하여 보안 역할 제거
이 명령은 MainSecurityRole이라는 보안 역할을 제거합니다. 명령은 Force 매개 변수를 사용하므로 확인을 요청하지 않습니다.
Remove-CMSecurityRole -Name "MainSecurityRole" -Force
예제 2: 변수를 사용하여 보안 역할 제거
첫 번째 명령은 Get-CMSecurityRole cmdlet을 사용하여 로 Custom
시작하는 모든 보안 역할을 가져와 서 $role 변수에 저장합니다.
두 번째 명령은 배열에 저장된 첫 번째 보안 역할을 제거합니다. Force 매개 변수를 지정하지 않으므로 이 명령은 확인을 요청합니다.
$role = Get-CMSecurityRole -Name "Custom*"
Remove-CMSecurityRole -InputObject $role[1]
매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Force
사용자 확인을 요청하지 않고 명령을 강제로 실행합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Id
제거할 보안 역할의 ID를 지정합니다. 이 값은 RoleID
속성입니다. 이 cmdlet은 사용자 지정 역할에서만 작동하므로 이 값은 항상 사이트 코드로 시작해야 합니다. (기본 제공 역할의 ID는 로 시작 SMS
합니다.)
형식: | String |
별칭: | RoleId |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-InputObject
제거할 보안 역할 개체를 지정합니다. 이 개체를 얻으려면 Get-CMSecurityRole cmdlet을 사용합니다.
형식: | IResultObject |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Name
제거할 보안 역할의 이름을 지정합니다.
형식: | String |
별칭: | RoleName |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | True |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
System.Object