Remove-EntraAgentUser

Modül:
Microsoft.Entra.Users Module v1.3

Bir Aracı Kullanıcısını kimliğine göre siler veya Bir Aracı Kimliği ile ilişkili tüm Aracı Kullanıcılarını siler.

Syntax

ByUserId (Varsayılan) 

Remove-EntraAgentUser

    -AgentUserId <String>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByAgentId 

Remove-EntraAgentUser

    -AgentId <String>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

cmdlet'i Remove-EntraAgentUser aracı kullanıcıları Microsoft Entra siler. ile -AgentUserIdkullanıldığında, kimliğine göre tek bir aracı kullanıcı siler. ile -AgentIdkullanıldığında, belirtilen Aracı Kimliği ile ilişkili tüm aracı kullanıcılarını arar ve siler.

Cmdlet, anahtar kullanılmadığı sürece -Force silinmeden önce onay gerektirir. Silme işlemini gerçekleştirmeden hangi kullanıcıların silineceğini önizlemek için kullanın -WhatIf .

Örnekler

Örnek 1: Bir Aracı Kullanıcısının Kimliğini Silme

Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentUser -AgentUserId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"

Bu örnek, belirtilen kimlikle Aracı Kullanıcısını siler. Sizden onay istenir.

Örnek 2: Bir Aracı Kullanıcıyı doğrulamadan kimlikle silme

Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentUser -AgentUserId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -Force

Bu örnek, onay istemeden Aracı Kullanıcısını siler.

Örnek 3: Bir Aracı Kimliği için Tüm Aracı Kullanıcılarını Silme

Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentUser -AgentId "cccccccc-3333-4444-5555-dddddddddddd" -Force

Bu örnek, belirtilen Aracı Kimliği ile ilişkili tüm Aracı Kullanıcılarını arar ve siler.

Örnek 4: WhatIf ile silme önizlemesi

Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentUser -AgentId "cccccccc-3333-4444-5555-dddddddddddd" -WhatIf

Bu örnekte, silme işlemi gerçekleştirilmeden hangi Aracı Kullanıcılarının silineceği gösterilmektedir.

Örnek 5: Hata işleme ile silme

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: $_"
}

Bu örnekte, hata işleme ile aracı kullanıcısının nasıl silineceği gösterilmektedir.

Parametreler

-AgentId

İlişkili Aracı Kullanıcıları silinmesi gereken Aracı Kimliğinin kimliği. Cmdlet, bu Aracı Kimliğine bağlı tüm Aracı Kullanıcılarını arar ve siler. ByAgentId parametre kümesiyle kullanılır.

Parametre özellikleri

Tür:System.String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ByAgentId
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-AgentUserId

Silinecek Aracı Kullanıcı kimliği. ByUserId parametre kümesiyle kullanılır.

Parametre özellikleri

Tür:System.String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ByUserId
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Parametre özellikleri

Tür:System.Management.Automation.SwitchParameter
Default value:True
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Force

Silmeden önce onay istemini gizler.

Parametre özellikleri

Tür:System.Management.Automation.SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Parametre özellikleri

Tür:System.Management.Automation.SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Çıkışlar

System.Collections.Hashtable

Şu özelliklere sahip bir karma tablo (veya kullanırken -AgentIdkarma tablo dizisi) döndürür: Id, DisplayName, AgentId ve Status.

Notlar

Bu cmdlet aşağıdaki Microsoft Graph izinlerini gerektirir:

  • AgentIdUser.ReadWrite.All

Cmdlet etkin bir Microsoft Entra bağlantısı gerektirir. Önce bağlanmak için kullanın Connect-Entra -Scopes 'AgentIdUser.ReadWrite.All' .

cmdlet'i kullanılırken -AgentId, ilk olarak Aracı Kimliği ile ilişkili tüm Aracı Kullanıcıları sorgular, ardından her birini siler. Aracı Kimliği'nin ilişkili Aracı Kullanıcısı yoksa, bir uyarı görüntülenir.