Remove-EntraAgentIdentityBlueprint

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

Bir Aracı Kimliği Şemasını ve ilişkili tüm Aracı Kimliklerini ve Aracı Kullanıcılarını siler.

Syntax

Default (Varsayılan) 

Remove-EntraAgentIdentityBlueprint

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

Description

cmdlet'iRemove-EntraAgentIdentityBlueprint, Microsoft Entra aracı kimliği şemasının art arda silinmesini gerçekleştirir. O:

  1. Şemayla ilişkili tüm Aracı Kimliklerini bulur
  2. Her Aracı Kimliği için ilişkili tüm Aracı Kullanıcılarını bulur ve siler
  3. Her Aracı Kimliğini siler
  4. Aracı Kimliği Şemasının kendisini 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: Şemayı ve ilişkili tüm kaynakları silme

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

Bu örnek, onay istemeden şemayı, tüm Aracı Kimliklerini ve ilişkili tüm Aracı Kullanıcılarını siler.

Örnek 2: WhatIf ile silme önizlemesi

Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All', 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -WhatIf

Bu örnekte, herhangi bir silme işlemi yapılmadan hangi kaynakların silineceği gösterilir.

Örnek 3: Onay ile silme ve sonuçları inceleme

Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All', 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
$result = Remove-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
Write-Host "Deleted Blueprint: $($result.BlueprintName)"
Write-Host "Deleted $($result.DeletedIdentities.Count) Agent Identity(ies)"
Write-Host "Deleted $($result.DeletedUsers.Count) Agent User(s)"

Bu örnek, etkileşimli onay ile şemayı siler ve sonuçları inceler.

Parametreler

-BlueprintId

Silinecek Aracı Kimliği Şemasının kimliği. Cmdlet, bu şemayla ilişkili tüm Aracı Kimliklerini ve Aracı Kullanıcılarını art arda siler.

Parametre özellikleri

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

Parametre kümeleri

(All)
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 döndürür: BlueprintId, BlueprintName, DeletedIdentities (silinen Aracı Kimliği bilgileri dizisi), DeletedUsers (silinen Aracı Kullanıcı bilgileri dizisi) ve Durum.

Notlar

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

  • AgentIdentityBlueprint.ReadWrite.All
  • 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 .

Silme sırası: Önce Aracı Kullanıcıları, ardından Aracı Kimlikleri ve son olarak şemanın kendisi silinir. Tek bir Aracı Kullanıcı veya Aracı Kimliği silme işlemi başarısız olursa, bir uyarı görüntülenir ve cmdlet kalan kaynaklarla devam eder.

Şemada çok sayıda Aracı Kimliği olduğunda, cmdlet tümünün bulunduğundan emin olmak için sayfalandırmayı destekler.