Remove-EntraAgentIdentity

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

Bir Aracı Kimliğini kimliğine göre siler veya Bir Aracı Kimliği Şeması ile ilişkili tüm Aracı Kimliklerini (ve Aracı Kullanıcılarını) siler.

Syntax

ByAgentId (Varsayılan) 

Remove-EntraAgentIdentity

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

ByBlueprintId 

Remove-EntraAgentIdentity

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

Description

cmdlet'i Remove-EntraAgentIdentity v1.0 API'sini kullanarak aracı kimliklerini Microsoft Entra siler. ile -AgentIdkullanıldığında tek bir Aracı Kimliği ve ilişkili Aracı Kullanıcıları silinir. ile -AgentIdentityBlueprintIdkullanıldığında şema için tüm Aracı Kimliklerini arar ve ilişkili Aracı Kullanıcıları ile birlikte her birini siler.

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

Örnekler

Örnek 1: Kimliğe Göre Aracı Kimliğini Silme

Connect-Entra -Scopes 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentity -AgentId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -Force

Bu örnek, Aracı Kimliği'ni ve ilişkili Aracı Kullanıcılarını siler.

Örnek 2: Şema için tüm Aracı Kimliklerini silme

Connect-Entra -Scopes 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentity -AgentIdentityBlueprintId "cccccccc-3333-4444-5555-dddddddddddd" -Force

Bu örnek, belirtilen Şema ile ilişkili tüm Aracı Kimliklerini arar, Aracı Kullanıcılarını siler ve ardından Aracı Kimliklerini kendileri siler.

Örnek 3: WhatIf ile silme önizlemesi

Connect-Entra -Scopes 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentity -AgentIdentityBlueprintId "cccccccc-3333-4444-5555-dddddddddddd" -WhatIf

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

Örnek 4: Hata işleme ile silme

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

Bu örnek, hata işleme ile aracı kimliğini silmeyi ve silinen Aracı Kullanıcılarını incelemeyi gösterir.

Parametreler

-AgentId

Silinecek Aracı Kimliğinin kimliği. Cmdlet, bu Aracı Kimliği ile ilişkilendirilmiş tüm Aracı Kullanıcılarını da 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

-AgentIdentityBlueprintId

Aracı Kimliği Şemasının Kimliği. Bu şemayla ilişkili tüm Aracı Kimlikleri, Aracı Kullanıcıları ile birlikte silinir. ByBlueprintId parametre kümesiyle kullanılır.

Parametre özellikleri

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

Parametre kümeleri

ByBlueprintId
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

Id, DisplayName, AgentIdentityBlueprintId, DeletedAgentUsers (silinen kullanıcı bilgileri dizisi) ve Status özelliklerine sahip bir karma tablo (veya kullanırken -AgentIdentityBlueprintIdkarma tablo dizisi) döndürür.

Notlar

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

  • AgentIdentity.DeleteRestore.All
  • AgentIdUser.ReadWrite.All

Cmdlet etkin bir Microsoft Entra bağlantısı gerektirir. Önce bağlanmak için yukarıdaki kapsamlarla kullanın Connect-Entra .

Bir Aracı Kimliği silinirken, önce ilişkili Aracı Kullanıcıları silinir. Aracı Kullanıcı silme işlemi başarısız olursa hata günlüğe kaydedilir ancak Aracı Kimliği silme işlemi devam eder.

cmdlet'i kullanılırken -AgentIdentityBlueprintId, birçok Aracı Kimliği ile şemaları işlemek için sayfalandırmayı destekler.