New-EntraApplicationExtensionProperty
Crée une propriété d’extension d’application.
Syntaxe
Default (Par défaut)
New-EntraApplicationExtensionProperty
-ApplicationId <String>
[-Name <String>]
[-DataType <String>]
[-TargetObjects <System.Collections.Generic.List`1[System.String]>]
[-IsMultiValued <Boolean>]
[<CommonParameters>]
Description
L’applet New-EntraApplicationExtensionProperty de commande crée une propriété d’extension d’application pour un objet dans Microsoft Entra ID.
Exemples
Exemple 1 : Créer une propriété d’extension
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 {}
Cette commande crée une propriété d’extension d’application du type de chaîne pour l’objet spécifié.
-
-ApplicationIdspécifie l’identificateur unique d’une application. -
-Namespécifie le nom de la propriété d’extension.
Exemple 2 : Créer une propriété d’extension avec un paramètre de type de données
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 {}
Cette commande crée une propriété d’extension d’application du type de données spécifié pour l’objet spécifié.
-
-ApplicationIdspécifie l’identificateur unique d’une application. -
-Namespécifie le nom de la propriété d’extension. -
-DataTypespécifie le type de données de la valeur que la propriété d’extension peut contenir.
Exemple 3 : Créer une propriété d’extension avec le paramètre cibles
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}
L’exemple montre comment créer une propriété d’extension d’application avec les objets cibles spécifiés pour l’objet spécifié.
-
-ApplicationIdspécifie l’identificateur unique d’une application. -
-Namespécifie le nom de la propriété d’extension. -
-TargetObjectsspécifie les ressources Microsoft Graph qui utilisent la propriété d’extension. Toutes les valeurs doivent être en PascalCase.
Paramètres
-ApplicationId
Spécifie un ID unique d’une application dans Microsoft Entra ID.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Identifiant d'objet (ObjectId) |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-DataType
Spécifie le type de données de la valeur que la propriété d’extension peut contenir. Les valeurs suivantes sont prises en charge.
- Binaire - 256 octets maximum
- Boolean
- DateTime : doit être spécifié au format ISO 8601. Conservées au format UTC.
- Entier - Valeur 32 bits.
- LargeInteger - Valeur 64 bits.
- Chaîne - 256 caractères maximum
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-IsMultiValued
Spécifie si la propriété d’extension prend en charge plusieurs valeurs. Définissez ce paramètre sur $true si la propriété d’extension peut contenir plusieurs valeurs ; sinon, définissez-le sur $false.
Propriétés du paramètre
| Type: | System.Boolean |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Spécifie le nom de la propriété d’extension.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TargetObjects
Spécifie les ressources Microsoft Graph qui peuvent utiliser la propriété d’extension. Toutes les valeurs doivent être en PascalCase. Les valeurs suivantes sont prises en charge.
- Utilisateur
- Groupe
- Unité administrative
- Application
- Appareil
- Organization
Propriétés du paramètre
| Type: | System.Collections.Generic.List`1[System.String] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.