New-EntraApplicationExtensionProperty
Skapar en apptilläggsegenskap.
Syntax
Default (Standard)
New-EntraApplicationExtensionProperty
-ApplicationId <String>
[-Name <String>]
[-DataType <String>]
[-TargetObjects <System.Collections.Generic.List`1[System.String]>]
[-IsMultiValued <Boolean>]
[<CommonParameters>]
Description
Cmdleten New-EntraApplicationExtensionProperty skapar en programtilläggsegenskap för ett objekt i Microsoft Entra ID.
Exempel
Exempel 1: Skapa en tilläggsegenskap
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 {}
Det här kommandot skapar en programtilläggsegenskap av strängtypen för det angivna objektet.
-
-ApplicationIdparameter anger den unika identifieraren för ett program. -
-Nameparameter anger namnet på tilläggsegenskapen.
Exempel 2: Skapa en tilläggsegenskap med datatypsparameter
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 {}
Det här kommandot skapar en programtilläggsegenskap för den angivna datatypen för det angivna objektet.
-
-ApplicationIdparameter anger den unika identifieraren för ett program. -
-Nameparameter anger namnet på tilläggsegenskapen. -
-DataTypeparameter anger datatypen för det värde som egenskapen extension kan innehålla.
Exempel 3: Skapa en tilläggsegenskap med målparametern
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}
Exemplet visar hur du skapar en programtilläggsegenskap med de angivna målobjekten för det angivna objektet.
-
-ApplicationIdparameter anger den unika identifieraren för ett program. -
-Nameparameter anger namnet på tilläggsegenskapen. -
-TargetObjectsparametern anger de Microsoft Graph resurser som använder tilläggets egenskap. Alla värden måste finnas i PascalCase.
Parametrar
-ApplicationId
Anger ett unikt ID för ett program i Microsoft Entra ID.
Parameteregenskaper
| Typ: | System.String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Objekt-ID |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-DataType
Anger datatypen för det värde som tilläggsegenskapen kan innehålla. Följande värden stöds.
- Binärt – maximalt 256 byte
- Boolean
- DateTime – måste anges i ISO 8601-format. Lagras i UTC.
- Heltal – 32-bitars värde.
- LargeInteger – 64-bitars värde.
- Sträng – maximalt 256 tecken
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 |
-IsMultiValued
Anger om tilläggsegenskapen stöder flera värden. Ange den här parametern till $true om tilläggsegenskapen kan innehålla flera värden. annars ställer du in den på $false.
Parameteregenskaper
| Typ: | System.Boolean |
| Standardvärde: | False |
| 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 |
-Name
Anger namnet på tilläggsegenskapen.
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 |
-TargetObjects
Anger de Microsoft Graph resurser som kan använda tilläggsegenskapen. Alla värden måste finnas i PascalCase. Följande värden stöds.
- Användare
- Group
- Administrativ Enhet
- Application
- Enhet
- Organization
Parameteregenskaper
| Typ: | System.Collections.Generic.List`1[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.