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。