Remove-EntraAgentUser
Törli az ügynökfelhasználót az azonosítója alapján, vagy törli az ügynökidentitáshoz társított összes ügynökfelhasználót.
Syntax
ByUserId (Alapértelmezett)
Remove-EntraAgentUser
-AgentUserId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByAgentId
Remove-EntraAgentUser
-AgentId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Remove-EntraAgentUser parancsmag törli az ügynökfelhasználókat a Microsoft Entra. A használat során -AgentUserIdegyetlen ügynökfelhasználót töröl azonosító alapján. A használat során -AgentIdmegkeresi és törli a megadott ügynökidentitáshoz társított összes ügynökfelhasználót.
A parancsmag a törlés előtt megerősítést igényel, kivéve, ha a -Force kapcsolót használja. Annak megtekintésére használható -WhatIf , hogy mely felhasználók törölhetők a törlés tényleges végrehajtása nélkül.
Példák
1. példa: Ügynökfelhasználó törlése azonosító alapján
Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentUser -AgentUserId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
Ez a példa törli a megadott azonosítóval rendelkező ügynökfelhasználót. A rendszer megerősítést kér.
2. példa: Ügynökfelhasználó törlése azonosító alapján megerősítés nélkül
Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentUser -AgentUserId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -Force
Ez a példa anélkül törli az ügynökfelhasználót, hogy megerősítést kér.
3. példa: Ügynökidentitás összes ügynökfelhasználójának törlése
Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentUser -AgentId "cccccccc-3333-4444-5555-dddddddddddd" -Force
Ez a példa megkeresi a megadott ügynökidentitáshoz társított összes ügynökfelhasználót, és törli őket.
4. példa: Előzetes törlés a WhatIf használatával
Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentUser -AgentId "cccccccc-3333-4444-5555-dddddddddddd" -WhatIf
Ez a példa bemutatja, hogy mely ügynökfelhasználók törölhetők a törlés tényleges végrehajtása nélkül.
5. példa: Törlés hibakezeléssel
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: $_"
}
Ez a példa bemutatja, hogyan törölhet egy ügynökfelhasználót hibakezeléssel.
Paraméterek
-AgentId
Annak az ügynökidentitásnak az azonosítója, amelynek társított ügynökfelhasználói törölve lesznek. A parancsmag megkeresi az ügynökidentitáshoz csatlakozó összes ügynökfelhasználót, és törli őket. A ByAgentId paraméterkészlettel használható.
Paramétertulajdonságok
| Típus: | System.String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ByAgentId
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-AgentUserId
A törölni kívánt ügynökfelhasználó azonosítója. A ByUserId paraméterkészlettel használható.
Paramétertulajdonságok
| Típus: | System.String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ByUserId
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | System.Management.Automation.SwitchParameter |
| Alapértelmezett érték: | True |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Force
Törlés előtt letiltja a megerősítési kérést.
Paramétertulajdonságok
| Típus: | System.Management.Automation.SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | System.Management.Automation.SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
None
Kimenetek
System.Collections.Hashtable
A következő tulajdonságokkal rendelkező kivonatolót (vagy ha használja -AgentIda kivonatolótömböt) ad vissza: Id, DisplayName, AgentId és Status.
Jegyzetek
Ehhez a parancsmaghoz a következő Microsoft Graph engedélyek szükségesek:
- AgentIdUser.ReadWrite.All
A parancsmag aktív Microsoft Entra kapcsolatot igényel. Először a csatlakozáshoz használható Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All' .
Ha ezt használja -AgentId, a parancsmag először lekérdezi az ügynökidentitáshoz társított összes ügynökfelhasználót, majd törli őket. Ha az ügynökidentitás nem rendelkezik társított ügynökfelhasználóval, figyelmeztetés jelenik meg.