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.
-
-ApplicationIdparameter geeft de unieke id van een toepassing. -
-Nameparameter 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.
-
-ApplicationIdparameter geeft de unieke id van een toepassing. -
-Nameparameter geeft de naam van de extensie-eigenschap. -
-DataTypeparameter 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.
-
-ApplicationIdparameter geeft de unieke id van een toepassing. -
-Nameparameter 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.