New-EntraAgentIdentityBlueprint

Tworzy nową strategię tożsamości agenta.

Składnia

Default (domyślnie)

New-EntraAgentIdentityBlueprint

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

Opis

Polecenie New-EntraAgentIdentityBlueprint cmdlet tworzy nową strategię tożsamości agenta przy użyciu interfejsu API Microsoft Graph w wersji 1.0. Strategia tożsamości agenta służy jako szablon do tworzenia tożsamości agenta z spójną konfiguracją i uprawnieniami.

Przykłady

Przykład 1. Tworzenie strategii przy użyciu sponsorów i właścicieli

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

W tym przykładzie tworzona jest strategia tożsamości agenta z określoną nazwą wyświetlaną, sponsorami i właścicielami.

Przykład 2. Tworzenie strategii przy użyciu sponsorów użytkowników i grup

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

W tym przykładzie tworzona jest strategia tożsamości agenta z sponsorami użytkowników i grup.

Przykład 3. Tworzenie strategii z tylko sponsorami użytkowników

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

W tym przykładzie jest tworzona strategia tożsamości agenta z wieloma sponsorami użytkowników.

Parametry

-DisplayName

Nazwa wyświetlana strategii tożsamości agenta.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-OwnerUserIds

Tablica identyfikatorów użytkowników lub nazw UPN do ustawienia jako właścicieli.

Właściwości parametru

Typ:

System.String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SponsorGroupIds

Tablica identyfikatorów grup do ustawienia jako sponsorów.

Właściwości parametru

Typ:

System.String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SponsorUserIds

Tablica identyfikatorów użytkowników lub nazw UPN do ustawienia jako sponsorów.

Właściwości parametru

Typ:

System.String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Dane wyjściowe

System.String

Zwraca identyfikator strategii tożsamości agenta.

Notatki

Należy określić co najmniej jednego sponsora (użytkownika lub grupy). Właściciele są opcjonalni. Jeśli sponsorzy lub właściciele nie są dostarczani jako parametry, polecenie cmdlet monituje interaktywnie i sugeruje bieżącego użytkownika jako domyślne. Polecenie cmdlet weryfikuje wszystkie identyfikatory użytkowników i grup względem dzierżawy przed utworzeniem strategii. Identyfikator strategii jest przechowywany w zmiennej na poziomie modułu do użycia przez inne powiązane polecenia cmdlet.

To polecenie cmdlet używa punktu końcowego interfejsu API Microsoft Graph w wersji 1.0 (/v1.0/applications/graph.agentIdentityBlueprint).

To polecenie cmdlet wymaga następujących uprawnień Microsoft Graph:

  • AgentIdentityBlueprint.Create
  • AgentIdentityBlueprint.UpdateAuthProperties.All