Remove-EntraAgentUser
해당 ID로 에이전트 사용자를 삭제하거나 에이전트 ID와 연결된 모든 에이전트 사용자를 삭제합니다.
구문
ByUserId (기본값)
Remove-EntraAgentUser
-AgentUserId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByAgentId
Remove-EntraAgentUser
-AgentId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
cmdlet은 Remove-EntraAgentUser Microsoft Entra 에이전트 사용자를 삭제합니다. 함께 -AgentUserId사용하면 ID별로 단일 에이전트 사용자를 삭제합니다. 함께 -AgentId사용하면 지정된 에이전트 ID와 연결된 모든 에이전트 사용자를 조회하고 삭제합니다.
스위치를 사용하지 않는 한 삭제하기 전에 cmdlet을 -Force 확인해야 합니다. 실제로 삭제를 수행하지 않고 삭제할 사용자를 미리 보는 데 사용합니다 -WhatIf .
예제
예제 1: ID로 에이전트 사용자 삭제
Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentUser -AgentUserId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
다음은 지정된 ID를 사용하여 에이전트 사용자를 삭제하는 예제입니다. 확인하라는 메시지가 표시됩니다.
예제 2: 확인 없이 ID로 에이전트 사용자 삭제
Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentUser -AgentUserId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -Force
다음은 확인 메시지를 표시하지 않고 에이전트 사용자를 삭제하는 예제입니다.
예제 3: 에이전트 ID에 대한 모든 에이전트 사용자 삭제
Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentUser -AgentId "cccccccc-3333-4444-5555-dddddddddddd" -Force
다음은 지정한 에이전트 ID와 연결된 모든 에이전트 사용자를 조회하여 삭제하는 예제입니다.
예제 4: WhatIf를 사용하여 삭제 미리 보기
Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentUser -AgentId "cccccccc-3333-4444-5555-dddddddddddd" -WhatIf
이 예제에서는 실제로 삭제를 수행하지 않고 삭제할 에이전트 사용자를 보여줍니다.
예제 5: 오류 처리로 삭제
Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All'
try {
$result = Remove-EntraAgentUser -AgentUserId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -Force
Write-Host "Deleted: $($result.DisplayName)"
} catch {
Write-Host "Failed to delete: $_"
}
이 예제에서는 오류 처리를 사용하여 에이전트 사용자를 삭제하는 방법을 보여 줍니다.
매개 변수
-AgentId
연결된 에이전트 사용자를 삭제해야 하는 에이전트 ID입니다. cmdlet은 이 에이전트 ID에 연결된 모든 에이전트 사용자를 조회하고 삭제합니다. ByAgentId 매개 변수 집합과 함께 사용됩니다.
매개 변수 속성
| 형식: | System.String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
ByAgentId
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-AgentUserId
삭제할 에이전트 사용자의 ID입니다. ByUserId 매개 변수 집합과 함께 사용됩니다.
매개 변수 속성
| 형식: | System.String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
ByUserId
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
| 형식: | System.Management.Automation.SwitchParameter |
| Default value: | True |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | Cf |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Force
삭제하기 전에 확인 프롬프트를 표시하지 않습니다.
매개 변수 속성
| 형식: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
매개 변수 속성
| 형식: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
None
출력
System.Collections.Hashtable
Id, DisplayName, AgentId 및 Status 속성과 함께 해시 테이블(또는 사용하는 -AgentId경우 해시 테이블 배열)을 반환합니다.
참고
이 cmdlet에는 다음 Microsoft Graph 권한이 필요합니다.
- AgentIdUser.ReadWrite.All
cmdlet에는 활성 Microsoft Entra 연결이 필요합니다. 먼저 연결하는 데 사용합니다 Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All' .
사용하는 -AgentId경우 cmdlet은 먼저 에이전트 ID와 연결된 모든 에이전트 사용자를 쿼리한 다음 각 사용자를 삭제합니다. 에이전트 ID에 연결된 에이전트 사용자가 없으면 경고가 표시됩니다.