New-EntraApplicationExtensionProperty

Hiermee maakt u een toepassingsextensieeigenschap.

Syntax

Default (Standaard)

New-EntraApplicationExtensionProperty

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

Description

De New-EntraApplicationExtensionProperty cmdlet maakt een toepassingsextensieeigenschap voor een object in Microsoft Entra ID.

Voorbeelden

Voorbeeld 1: Een extensie-eigenschap maken

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 {}

Met deze opdracht maakt u een toepassingsextensieeigenschap van het tekenreekstype voor het opgegeven object.

  • -ApplicationId parameter geeft de unieke id van een toepassing.
  • -Name parameter geeft de naam van de extensie-eigenschap.

Voorbeeld 2: Een extensie-eigenschap maken met parameter voor gegevenstype

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 {}

Met deze opdracht maakt u een toepassingsextensieeigenschap van het opgegeven gegevenstype voor het opgegeven object.

  • -ApplicationId parameter geeft de unieke id van een toepassing.
  • -Name parameter geeft de naam van de extensie-eigenschap.
  • -DataType parameter specificeert het gegevenstype van de waarde die de extensie-eigenschap kan bevatten.

Voorbeeld 3: Een extensie-eigenschap maken met de doelparameter

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}

In het voorbeeld ziet u hoe u een toepassingsextensieeigenschap maakt met de opgegeven doelobjecten voor het opgegeven object.

  • -ApplicationId parameter geeft de unieke id van een toepassing.
  • -Name parameter geeft de naam van de extensie-eigenschap.
  • -TargetObjectsparameter geeft de Microsoft Graph resources die gebruikmaken van de extensie-eigenschap. Alle waarden moeten in PascalCase staan.

Parameters

-ApplicationId

Hiermee geeft u een unieke id van een toepassing in Microsoft Entra ID.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ObjectId

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DataType

Hiermee geeft u het gegevenstype op van de waarde die de extensie-eigenschap kan bevatten. De volgende waarden worden ondersteund.

  • Binair - maximaal 256 bytes
  • Boolean
  • DateTime - Moet worden opgegeven in ISO 8601-indeling. Wordt opgeslagen in UTC.
  • Geheel getal - 32-bits waarde.
  • LargeInteger - 64-bits waarde.
  • Tekenreeks - maximaal 256 tekens

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IsMultiValued

Hiermee geeft u op of de extensie-eigenschap meerdere waarden ondersteunt. Stel deze parameter in op $true als de extensie-eigenschap meerdere waarden kan bevatten; anders stelt u deze in op $false.

Parametereigenschappen

Type:System.Boolean
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

Hiermee geeft u de naam van de extensie-eigenschap.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-TargetObjects

Hiermee geeft u de Microsoft Graph resources die de extensie-eigenschap kunnen gebruiken. Alle waarden moeten in PascalCase staan. De volgende waarden worden ondersteund.

  • User
  • Group
  • Beheereenheid
  • Application
  • Apparaat
  • Organization

Parametereigenschappen

Type:

System.Collections.Generic.List`1[System.String]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.