New-EntraApplicationExtensionProperty

Erstellt eine Anwendungserweiterungseigenschaft.

Syntax

Default (Standard)

New-EntraApplicationExtensionProperty

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

Beschreibung

Das New-EntraApplicationExtensionProperty Cmdlet erstellt eine Anwendungserweiterungseigenschaft für ein Objekt in Microsoft Entra ID.

Beispiele

Beispiel 1: Erstellen einer Erweiterungseigenschaft

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

Mit diesem Befehl wird eine Anwendungserweiterungseigenschaft des Zeichenfolgentyps für das angegebene Objekt erstellt.

  • -ApplicationId der Parameter gibt den eindeutigen Bezeichner einer Anwendung an.
  • -Name der Parameter gibt den Namen der Erweiterungseigenschaft an.

Beispiel 2: Erstellen einer Erweiterungseigenschaft mit Dem Datentypparameter

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

Mit diesem Befehl wird eine Anwendungserweiterungseigenschaft des angegebenen Datentyps für das angegebene Objekt erstellt.

  • -ApplicationId der Parameter gibt den eindeutigen Bezeichner einer Anwendung an.
  • -Name der Parameter gibt den Namen der Erweiterungseigenschaft an.
  • -DataType der Parameter gibt den Datentyp des Werts an, den die Erweiterungseigenschaft enthalten kann.

Beispiel 3: Erstellen einer Erweiterungseigenschaft mit zielparameter

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}

Das Beispiel zeigt, wie Eine Anwendungserweiterungseigenschaft mit den angegebenen Zielobjekten für das angegebene Objekt erstellt wird.

  • -ApplicationId der Parameter gibt den eindeutigen Bezeichner einer Anwendung an.
  • -Name der Parameter gibt den Namen der Erweiterungseigenschaft an.
  • -TargetObjectsder Parameter gibt die Microsoft Graph Ressourcen an, die die Erweiterungseigenschaft verwenden. Alle Werte müssen in PascalCase enthalten sein.

Parameter

-ApplicationId

Gibt eine eindeutige ID einer Anwendung in Microsoft Entra ID an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Objekt-ID

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DataType

Gibt den Datentyp des Werts an, den die Erweiterungseigenschaft enthalten kann. Folgende Werte werden unterstützt.

  • Binär - maximal 256 Bytes
  • Boolean
  • DateTime - Muss im ISO 8601-Format angegeben werden. Wird in UTC gespeichert.
  • Ganzzahl - 32-Bit-Wert.
  • LargeInteger - 64-Bit-Wert.
  • Zeichenfolge - maximal 256 Zeichen

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IsMultiValued

Gibt an, ob die Erweiterungseigenschaft mehrere Werte unterstützt. Legen Sie diesen Parameter auf $true fest, wenn die Erweiterungseigenschaft mehrere Werte enthalten kann; andernfalls legen Sie sie auf $false fest.

Parametereigenschaften

Typ:System.Boolean
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen der Erweiterungseigenschaft an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TargetObjects

Gibt die Microsoft Graph Ressourcen an, die die Erweiterungseigenschaft verwenden können. Alle Werte müssen in PascalCase enthalten sein. Die folgenden Werte werden unterstützt.

  • Benutzer
  • Gruppe
  • AdministrativeReferat
  • Anwendung
  • Gerät
  • Organization

Parametereigenschaften

Typ:

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

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.