New-EntraBetaAgentIDUserForAgentId

模組:
Microsoft.Entra.Beta.Users Module v1.3

使用代理身份建立新的代理使用者。

語法

Default (預設值) 

New-EntraBetaAgentIDUserForAgentId

    -DisplayName <String>
    [-UserPrincipalName <String>]
    [-AgentIdentityId <String>]
    [<CommonParameters>]

Description

該New-EntraBetaAgentIDUserForAgentId指令小程式透過將當前代理身份 ID 作為身份父，向 Microsoft Graph 使用者端發布資料來建立新的代理使用者。 mailNickname 是自動從 userPrincipalName 衍生而來。

範例

範例 1：建立包含所有參數的代理使用者

Connect-Entra -Scopes 'AgentIdentityBlueprint.Create', 'AgentIdentityBlueprintPrincipal.Create', 'AppRoleAssignment.ReadWrite.All', 'AgentIdentityBlueprint.ReadWrite.All', 'User.ReadWrite.All'
New-EntraBetaAgentIdentityBlueprint -DisplayName "My Blueprint" -SponsorUserIds @("admin@contoso.com")
New-EntraBetaAgentIDForAgentIdentityBlueprint -DisplayName "My Agent Identity" -SponsorUserIds @("user1@contoso.com")
New-EntraBetaAgentIDUserForAgentId -DisplayName "Agent Identity 26192008" -UserPrincipalName "AgentIdentity26192008@contoso.onmicrosoft.com"

此範例使用當前會話建立的代理身份，建立一個具有指定顯示名稱與使用者主體名稱的代理使用者。

範例 2：建立帶有提示的代理使用者

Connect-Entra -Scopes 'AgentIdentityBlueprint.Create', 'AgentIdentityBlueprintPrincipal.Create', 'AppRoleAssignment.ReadWrite.All', 'AgentIdentityBlueprint.ReadWrite.All', 'User.ReadWrite.All'
# Assumes Agent Identity Blueprint and Agent Identity are already created
New-EntraBetaAgentIDUserForAgentId -DisplayName "HR Agent User"

此範例創建代理使用者。 如果沒有提供，指令長會提示使用者主體名稱。

範例 3：為同一代理身份建立多個代理使用者

Connect-Entra -Scopes 'AgentIdentityBlueprint.Create', 'AgentIdentityBlueprintPrincipal.Create', 'AppRoleAssignment.ReadWrite.All', 'AgentIdentityBlueprint.ReadWrite.All', 'User.ReadWrite.All'
New-EntraBetaAgentIdentityBlueprint -DisplayName "Finance Blueprint" -SponsorUserIds @("finance-admin@contoso.com")
New-EntraBetaAgentIDForAgentIdentityBlueprint -DisplayName "Finance Agent" -SponsorUserIds @("finance-user@contoso.com")

# Create first Agent User
New-EntraBetaAgentIDUserForAgentId -DisplayName "Finance Agent User 1" -UserPrincipalName "financeagent1@contoso.onmicrosoft.com"

# Create second Agent User for the same Agent Identity
New-EntraBetaAgentIDUserForAgentId -DisplayName "Finance Agent User 2" -UserPrincipalName "financeagent2@contoso.onmicrosoft.com"

此範例會建立多個與同一代理身份相關的代理使用者。

範例 4：建立具有明確代理身份 ID 的代理使用者

Connect-Entra -Scopes 'AgentIdentityBlueprint.Create', 'AgentIdentityBlueprintPrincipal.Create', 'AppRoleAssignment.ReadWrite.All', 'AgentIdentityBlueprint.ReadWrite.All', 'User.ReadWrite.All'
$agentIdentity = New-EntraBetaAgentIDForAgentIdentityBlueprint -DisplayName "My Agent Identity"
New-EntraBetaAgentIDUserForAgentId -DisplayName "Agent User" -UserPrincipalName "agentuser@contoso.onmicrosoft.com" -AgentIdentityId $agentIdentity.id

此範例透過明確提供代理身份 ID 來建立代理使用者，這在呼叫不同模組範圍或腳本時非常有用。

參數

-AgentIdentityId

與此使用者關聯的代理身份識別碼。 若未提供，指令檔會使用 New-EntraBetaAgentIDForAgentIdentityBlueprint 的儲存值。 在呼叫不同模組作用域或想明確指定代理身份時，請使用此參數。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DisplayName

代理使用者的顯示名稱。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-UserPrincipalName

代理使用者的使用者主體名稱（電子郵件）（例如 username@domain.onmicrosoft.com）。 電子郵件地址格式必須有效。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

None

輸出

System.Object

回傳包含 id、displayName、userPrincipalName、mailNickname 及 accountEnabled 等屬性的 Agent User 物件。

備註

需要一個代理身份識別碼，該識別碼可透過 -AgentIdentityId 參數提供，或是先前呼叫 New-EntraBetaAgentIDForAgentIdentityBlueprint 時儲存。 mailNickname 是自動從 userPrincipalName 中提取 @ 符號前的部分而產生的。 代理使用者是將 accountEnabled 設為 true 的。

此指令小程式需要以下 Microsoft Graph 權限：

  • AgentIdentityBlueprint.Create
  • 代理身份藍圖主體。創建
  • AppRoleAssignment.ReadWrite.All
  • AgentIdentity Blueprint.ReadWrite.All
  • User.ReadWrite.All