Remove-EntraAgentIdentity
해당 ID로 에이전트 ID를 삭제하거나 에이전트 ID 청사진과 연결된 모든 에이전트 ID(및 해당 에이전트 사용자)를 삭제합니다.
구문
ByAgentId (기본값)
Remove-EntraAgentIdentity
-AgentId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByBlueprintId
Remove-EntraAgentIdentity
-AgentIdentityBlueprintId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
cmdlet은 Remove-EntraAgentIdentity v1.0 API를 사용하여 Microsoft Entra 에이전트 ID를 삭제합니다. 함께 -AgentId사용하면 단일 에이전트 ID 및 연결된 에이전트 사용자를 삭제합니다. 함께 -AgentIdentityBlueprintId사용하면 청사진에 대한 모든 에이전트 ID를 조회하고 연결된 에이전트 사용자와 함께 각 ID를 삭제합니다.
스위치를 사용하지 않는 한 삭제하기 전에 cmdlet을 -Force 확인해야 합니다. 실제로 삭제를 수행하지 않고 삭제할 리소스를 미리 보는 데 사용합니다 -WhatIf .
예제
예제 1: ID로 에이전트 ID 삭제
Connect-Entra -Scopes 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentity -AgentId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -Force
다음은 에이전트 ID 및 연결된 에이전트 사용자를 삭제하는 예제입니다.
예제 2: 청사진에 대한 모든 에이전트 ID 삭제
Connect-Entra -Scopes 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentity -AgentIdentityBlueprintId "cccccccc-3333-4444-5555-dddddddddddd" -Force
이 예제에서는 지정된 청사진과 연결된 모든 에이전트 ID를 조회하고 해당 에이전트 사용자를 삭제한 다음 에이전트 ID 자체를 삭제합니다.
예제 3: WhatIf를 사용하여 삭제 미리 보기
Connect-Entra -Scopes 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentity -AgentIdentityBlueprintId "cccccccc-3333-4444-5555-dddddddddddd" -WhatIf
이 예제에서는 삭제를 수행하지 않고 삭제할 에이전트 ID 및 에이전트 사용자를 보여줍니다.
예제 4: 오류 처리로 삭제
Connect-Entra -Scopes 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
try {
$result = Remove-EntraAgentIdentity -AgentId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -Force
Write-Host "Deleted Agent Identity: $($result.DisplayName)"
Write-Host "Also deleted $($result.DeletedAgentUsers.Count) Agent User(s)"
} catch {
Write-Host "Failed to delete: $_"
}
이 예제에서는 오류 처리로 에이전트 ID를 삭제하고 삭제된 에이전트 사용자를 검사하는 방법을 보여 줍니다.
매개 변수
-AgentId
삭제할 에이전트 ID의 ID입니다. 또한 cmdlet은 이 에이전트 ID와 연결된 모든 에이전트 사용자를 삭제합니다. ByAgentId 매개 변수 집합과 함께 사용됩니다.
매개 변수 속성
| 형식: | System.String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
ByAgentId
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-AgentIdentityBlueprintId
에이전트 ID 청사진의 ID입니다. 이 청사진과 연결된 모든 에이전트 ID는 해당 에이전트 사용자와 함께 삭제됩니다. ByBlueprintId 매개 변수 집합과 함께 사용됩니다.
매개 변수 속성
| 형식: | System.String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
ByBlueprintId
| 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, AgentIdentityBlueprintId, DeletedAgentUsers(삭제된 사용자 정보 배열) 및 상태와 함께 해시 테이블(또는 사용하는 -AgentIdentityBlueprintId경우 해시 테이블 배열)을 반환합니다.
참고
이 cmdlet에는 다음 Microsoft Graph 권한이 필요합니다.
- AgentIdentity.DeleteRestore.All
- AgentIdUser.ReadWrite.All
cmdlet에는 활성 Microsoft Entra 연결이 필요합니다. 위의 범위와 함께 사용하여 Connect-Entra 먼저 연결합니다.
에이전트 ID를 삭제할 때 연결된 모든 에이전트 사용자가 먼저 삭제됩니다. 에이전트 사용자 삭제에 실패하면 오류가 기록되지만 에이전트 ID 삭제는 계속 진행됩니다.
이 cmdlet을 사용하는 -AgentIdentityBlueprintId경우 cmdlet은 많은 에이전트 ID를 사용하여 청사진을 처리하는 페이지 매김을 지원합니다.