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.
-
-ApplicationIdel parámetro especifica el identificador único de una aplicación. -
-Nameparameter 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.
-
-ApplicationIdel parámetro especifica el identificador único de una aplicación. -
-Nameparameter especifica el nombre de la propiedad de extensión. -
-DataTypeparameter 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.
-
-ApplicationIdel parámetro especifica el identificador único de una aplicación. -
-Nameparameter 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.