New-EntraAgentIdentityBlueprint

Modul:
Microsoft.Entra.Applications Module v1.3

Erstellt einen neuen Agent Identity Blueprint.

Syntax

Default (Standard) 

New-EntraAgentIdentityBlueprint

    -DisplayName <String>
    [-SponsorUserIds <String[]>]
    [-SponsorGroupIds <String[]>]
    [-OwnerUserIds <String[]>]
    [<CommonParameters>]

Beschreibung

Das New-EntraAgentIdentityBlueprint Cmdlet erstellt einen neuen Agent Identity Blueprint mithilfe der Microsoft Graph v1.0-API. Ein Agent Identity Blueprint dient als Vorlage zum Erstellen von Agentidentitäten mit konsistenter Konfiguration und Berechtigungen.

Beispiele

Beispiel 1: Erstellen eines Blueprints mit Sponsoren und Besitzern

Connect-Entra -Scopes 'AgentIdentityBlueprint.Create', 'AgentIdentityBlueprint.UpdateAuthProperties.All'
New-EntraAgentIdentityBlueprint -DisplayName "My Blueprint" -SponsorUserIds @("user1@contoso.com") -OwnerUserIds @("owner1@contoso.com")

12345678-1234-1234-1234-123456789012

In diesem Beispiel wird ein Agent Identity Blueprint mit dem angegebenen Anzeigenamen, Sponsoren und Besitzern erstellt.

Beispiel 2: Erstellen eines Blueprints mit Benutzer- und Gruppensponsoren

Connect-Entra -Scopes 'AgentIdentityBlueprint.Create', 'AgentIdentityBlueprint.UpdateAuthProperties.All'
New-EntraAgentIdentityBlueprint -DisplayName "HR Blueprint" -SponsorUserIds @("hr-admin@contoso.com") -SponsorGroupIds @("aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb")

87654321-4321-4321-4321-210987654321

In diesem Beispiel wird ein Agent Identity Blueprint mit Benutzer- und Gruppensponsoren erstellt.

Beispiel 3: Erstellen eines Blueprints mit nur Benutzersponsoren

Connect-Entra -Scopes 'AgentIdentityBlueprint.Create', 'AgentIdentityBlueprint.UpdateAuthProperties.All'
New-EntraAgentIdentityBlueprint -DisplayName "Finance Blueprint" -SponsorUserIds @("finance-admin@contoso.com", "finance-manager@contoso.com")

11112222-3333-4444-5555-666677778888

In diesem Beispiel wird ein Agent Identity Blueprint mit mehreren Benutzersponsoren erstellt.

Parameter

-DisplayName

Der Anzeigename für den Agent Identity Blueprint.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OwnerUserIds

Array von Benutzer-IDs oder UPNs, die als Besitzer festgelegt werden sollen.

Parametereigenschaften

Typ:

System.String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SponsorGroupIds

Array von Gruppen-IDs, die als Sponsoren festgelegt werden sollen.

Parametereigenschaften

Typ:

System.String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SponsorUserIds

Array von Benutzer-IDs oder UPNs, die als Sponsoren festgelegt werden sollen.

Parametereigenschaften

Typ:

System.String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Ausgaben

System.String

Gibt die Agent Identity Blueprint-ID zurück.

Hinweise

Mindestens ein Sponsor (Benutzer oder Gruppe) muss angegeben werden. Besitzer sind optional. Wenn Sponsoren oder Besitzer nicht als Parameter bereitgestellt werden, fordert das Cmdlet interaktiv auf und schlägt den aktuellen Benutzer als Standard vor. Das Cmdlet überprüft alle Benutzer- und Gruppen-IDs für den Mandanten, bevor der Blueprint erstellt wird. Die Blueprint-ID wird in einer Variablen auf Modulebene gespeichert, die von anderen verwandten Cmdlets verwendet werden kann.

Dieses Cmdlet verwendet den Microsoft Graph v1.0-API-Endpunkt (/v1.0/applications/graph.agentIdentityBlueprint).

Für dieses Cmdlet sind die folgenden Microsoft Graph Berechtigungen erforderlich:

  • AgentIdentityBlueprint.Create
  • AgentIdentityBlueprint.UpdateAuthProperties.All