New-EntraApplicationExtensionProperty

建立應用程式擴充屬性。

語法

Default (預設值)

New-EntraApplicationExtensionProperty

    -ApplicationId <String>
    [-Name <String>]
    [-DataType <String>]
    [-TargetObjects <System.Collections.Generic.List`1[System.String]>]
    [-IsMultiValued <Boolean>]
    [<CommonParameters>]

Description

該 New-EntraApplicationExtensionProperty cmdlet 為 Microsoft Entra ID 中的物件建立應用程式擴充屬性。

範例

範例 1:建立擴展屬性

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
New-EntraApplicationExtensionProperty -ApplicationId $application.Id -Name 'NewAttribute'
DeletedDateTime Id                                   AppDisplayName  DataType IsSyncedFromOnPremises Name                                                    TargetObjects
--------------- --                                   --------------  -------- ---------------------- ----                                                    -------------
                11112222-bbbb-3333-cccc-4444dddd5555 My new test app String   False                  extension_11112222-bbbb-3333-cccc-4444dddd5555_NewAttribute {}

此指令會為指定物件建立字串型別的應用程式擴充屬性。

  • -ApplicationId 參數指定應用程式的唯一識別碼。
  • -Name 參數指定擴充屬性的名稱。

範例 2:建立帶有資料型別參數的擴充屬性

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
New-EntraApplicationExtensionProperty -ApplicationId $application.Id -Name 'NewAttribute1' -DataType 'Boolean'
DeletedDateTime Id                                   AppDisplayName  DataType IsSyncedFromOnPremises Name                                                    TargetObjects
--------------- --                                   --------------  -------- ---------------------- ----                                                    -------------
                11112222-bbbb-3333-cccc-4444dddd5555 My new test app Boolean  False                  extension_11112222-bbbb-3333-cccc-4444dddd5555_NewAttribute {}

此指令會為指定物件建立指定資料型態的應用程式擴充屬性。

  • -ApplicationId 參數指定應用程式的唯一識別碼。
  • -Name 參數指定擴充屬性的名稱。
  • -DataType 參數指定擴充屬性可承載的值資料型態。

範例 3:建立帶有目標參數的擴充屬性

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
$targets = New-Object System.Collections.Generic.List[System.String]
$targets.Add('User')
New-EntraApplicationExtensionProperty -ApplicationId $application.Id -Name 'NewAttribute2' -TargetObjects $targets
DeletedDateTime Id                                   AppDisplayName  DataType IsSyncedFromOnPremises Name                                                    TargetObjects
--------------- --                                   --------------  -------- ---------------------- ----                                                    -------------
                11112222-bbbb-3333-cccc-4444dddd5555 My new test app String   False                  extension_11112222-bbbb-3333-cccc-4444dddd5555_NewAttribute {User}

範例展示了如何用指定的目標物件建立應用程式擴充屬性。

  • -ApplicationId 參數指定應用程式的唯一識別碼。
  • -Name 參數指定擴充屬性的名稱。
  • -TargetObjects參數指定使用 extension 屬性的 Microsoft Graph 資源。 所有值都必須在 PascalCase 中。

參數

-ApplicationId

在 Microsoft Entra ID 中指定應用程式的唯一 ID。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False
別名:ObjectId (物件識別碼)

參數集

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

-DataType

指定擴充屬性可持有的值資料型態。 支援以下數值。

  • 二進位 - 最大 256 位元組
  • 布林值
  • DateTime-必須以ISO 8601格式指定。 會儲存在UTC中。
  • 整數 - 32 位元值。
  • LargeInteger - 64 位元值。
  • 字串 - 最大 256 個字元

參數屬性

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

參數集

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

-IsMultiValued

指定擴展屬性是否支援多個值。 若擴充性能容納多個值,則將此參數設為 $true;否則,設為$false。

參數屬性

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

參數集

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

-Name

指定擴展屬性的名稱。

參數屬性

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

參數集

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

-TargetObjects

指定可以使用擴充功能屬性的 Microsoft Graph 資源。 所有值都必須在 PascalCase 中。 以下數值為支援。

  • 使用者
  • Group
  • 管理單位
  • Application
  • 裝置
  • Organization

參數屬性

類型:

System.Collections.Generic.List`1[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。