New-EntraAgentIdentityBlueprint
Skapar en ny agentidentitetsritning.
Syntax
Default (Standard)
New-EntraAgentIdentityBlueprint
-DisplayName <String>
[-SponsorUserIds <String[]>]
[-SponsorGroupIds <String[]>]
[-OwnerUserIds <String[]>]
[<CommonParameters>]
Description
Cmdleten New-EntraAgentIdentityBlueprint skapar en ny agentidentitetsritning med api:et Microsoft Graph v1.0. En agentidentitetsritning fungerar som en mall för att skapa agentidentiteter med konsekvent konfiguration och behörigheter.
Exempel
Exempel 1: Skapa en skiss med sponsorer och ägare
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
I det här exemplet skapas en agentidentitetsritning med det angivna visningsnamnet, sponsorerna och ägarna.
Exempel 2: Skapa en skiss med användar- och gruppsponsorer
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
I det här exemplet skapas en agentidentitetsritning med både användar- och gruppsponsorer.
Exempel 3: Skapa en skiss med endast användarsponsorer
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
I det här exemplet skapas en agentidentitetsritning med flera användarsponsorer.
Parametrar
-DisplayName
Visningsnamnet för agentidentitetsritningen.
Parameteregenskaper
| Typ: | System.String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-OwnerUserIds
Matris med användar-ID:er eller UPN som ska anges som ägare.
Parameteregenskaper
| Typ: | System.String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-SponsorGroupIds
Matris med grupp-ID:t som ska anges som sponsorer.
Parameteregenskaper
| Typ: | System.String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-SponsorUserIds
Matris med användar-ID:er eller UPN:er som ska anges som sponsorer.
Parameteregenskaper
| Typ: | System.String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
None
Utdata
System.String
Returnerar agentidentitetens skiss-ID.
Kommentarer
Minst en sponsor (användare eller grupp) måste anges. Ägare är valfria. Om sponsorer eller ägare inte tillhandahålls som parametrar frågar cmdleten interaktivt och föreslår den aktuella användaren som standard. Cmdleten validerar alla användar- och grupp-ID:t mot klientorganisationen innan skissen skapas. Skiss-ID:t lagras i en variabel på modulnivå för användning av andra relaterade cmdletar.
Den här cmdleten använder api-slutpunkten Microsoft Graph v1.0 (/v1.0/applications/graph.agentIdentityBlueprint).
Den här cmdleten kräver följande Microsoft Graph behörigheter:
- AgentIdentityBlueprint.Create
- AgentIdentityBlueprint.UpdateAuthProperties.All