New-EntraApplicationExtensionProperty

Crea una propiedad de extensión de aplicación.

Sintaxis

Default (valor predeterminado)

New-EntraApplicationExtensionProperty

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

Description

El New-EntraApplicationExtensionProperty cmdlet crea una propiedad de extensión de aplicación para un objeto en Microsoft Entra ID.

Ejemplos

Ejemplo 1: Crear una propiedad de extensión

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

Este comando crea una propiedad de extensión de aplicación del tipo de cadena para el objeto especificado.

  • -ApplicationId el parámetro especifica el identificador único de una aplicación.
  • -Name parameter especifica el nombre de la propiedad de extensión.

Ejemplo 2: Creación de una propiedad de extensión con el parámetro de tipo de datos

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

Este comando crea una propiedad de extensión de aplicación del tipo de datos especificado para el objeto especificado.

  • -ApplicationId el parámetro especifica el identificador único de una aplicación.
  • -Name parameter especifica el nombre de la propiedad de extensión.
  • -DataType parameter especifica el tipo de datos del valor que puede contener la propiedad de extensión.

Ejemplo 3: Creación de una propiedad de extensión con el parámetro targets

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}

En el ejemplo se muestra cómo crear una propiedad de extensión de aplicación con los objetos de destino especificados para el objeto especificado.

  • -ApplicationId el parámetro especifica el identificador único de una aplicación.
  • -Name parameter especifica el nombre de la propiedad de extensión.
  • -TargetObjectsparameter especifica el Microsoft Graph recursos que usan la propiedad de extensión. Todos los valores deben estar en PascalCase.

Parámetros

-ApplicationId

Especifica un identificador único de una aplicación en Microsoft Entra ID.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ObjectId (identificador de objeto)

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DataType

Especifica el tipo de datos del valor que puede contener la propiedad de extensión. Se admiten los siguientes valores.

  • Binario: máximo de 256 bytes
  • Booleano
  • DateTime: debe especificarse en formato ISO 8601. Se almacenarán en UTC.
  • Entero: valor de 32 bits.
  • LargeInteger: valor de 64 bits.
  • Cadena: máximo de 256 caracteres

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IsMultiValued

Especifica si la propiedad de extensión admite varios valores. Establezca este parámetro en $true si la propiedad de extensión puede contener varios valores; De lo contrario, establézcalo en $false.

Propiedades de parámetro

Tipo:System.Boolean
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica el nombre de la propiedad de extensión.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TargetObjects

Especifica los recursos Microsoft Graph que pueden usar la propiedad de extensión. Todos los valores deben estar en PascalCase. Se admiten los siguientes valores.

  • User
  • Group
  • Unidad Administrativa
  • Application
  • Dispositivo
  • Organization

Propiedades de parámetro

Tipo:

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

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.