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