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.
-
-ApplicationIdder Parameter gibt den eindeutigen Bezeichner einer Anwendung an. -
-Nameder 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.
-
-ApplicationIdder Parameter gibt den eindeutigen Bezeichner einer Anwendung an. -
-Nameder Parameter gibt den Namen der Erweiterungseigenschaft an. -
-DataTypeder 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.
-
-ApplicationIdder Parameter gibt den eindeutigen Bezeichner einer Anwendung an. -
-Nameder 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.