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.

  • -ApplicationId parameter anger den unika identifieraren för ett program.
  • -Name parameter 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.

  • -ApplicationId parameter anger den unika identifieraren för ett program.
  • -Name parameter anger namnet på tilläggsegenskapen.
  • -DataType parameter 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.

  • -ApplicationId parameter anger den unika identifieraren för ett program.
  • -Name parameter 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.