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é.

  • -ApplicationId spécifie l’identificateur unique d’une application.
  • -Name spé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é.

  • -ApplicationId spécifie l’identificateur unique d’une application.
  • -Name spécifie le nom de la propriété d’extension.
  • -DataType spé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é.

  • -ApplicationId spécifie l’identificateur unique d’une application.
  • -Name spé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.