New-EntraApplicationExtensionProperty

Módulo:
Microsoft.Entra.Applications Module v1.3

Cria uma propriedade de extensão de aplicativo.

Sintaxe

Default (Default) 

New-EntraApplicationExtensionProperty

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

Description

O New-EntraApplicationExtensionProperty cmdlet cria uma propriedade de extensão de aplicativo para um objeto em Microsoft Entra ID.

Exemplos

Exemplo 1: Criar uma propriedade de extensão

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

Esse comando cria uma propriedade de extensão de aplicativo do tipo de cadeia de caracteres para o objeto especificado.

  • -ApplicationId o parâmetro especifica o identificador exclusivo de um aplicativo.
  • -Name o parâmetro especifica o nome da propriedade de extensão.

Exemplo 2: criar uma propriedade de extensão com o parâmetro de tipo de dados

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

Esse comando cria uma propriedade de extensão de aplicativo do tipo de dados especificado para o objeto especificado.

  • -ApplicationId o parâmetro especifica o identificador exclusivo de um aplicativo.
  • -Name o parâmetro especifica o nome da propriedade de extensão.
  • -DataType o parâmetro especifica o tipo de dados do valor que a propriedade de extensão pode conter.

Exemplo 3: Criar uma propriedade de extensão com o 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}

O exemplo mostra como criar uma propriedade de extensão de aplicativo com os objetos de destino especificados para o objeto especificado.

  • -ApplicationId o parâmetro especifica o identificador exclusivo de um aplicativo.
  • -Name o parâmetro especifica o nome da propriedade de extensão.
  • -TargetObjectsO parâmetro especifica os recursos de Microsoft Graph que usam a propriedade de extensão. Todos os valores têm de estar em PascalCase.

Parâmetros

-ApplicationId

Especifica uma ID exclusiva de um aplicativo no Microsoft Entra ID.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:IdentificadorDeObjeto

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DataType

Especifica o tipo de dados do valor que a propriedade de extensão pode conter. São suportados os seguintes valores.

  • Binário – máximo de 256 bytes
  • booleano
  • DateTime – Deve ser especificado no formato ISO 8601. Serão armazenados no UTC.
  • Inteiro – valor de 32 bits.
  • LargeInteger – valor de 64 bits.
  • Cadeia de caracteres – máximo de 256 caracteres

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IsMultiValued

Especifica se a propriedade de extensão dá suporte a vários valores. Defina esse parâmetro como $true se a propriedade de extensão puder conter vários valores; caso contrário, defina-o como $false.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:False
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome da propriedade de extensão.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TargetObjects

Especifica os recursos de Microsoft Graph que podem usar a propriedade de extensão. Todos os valores têm de estar em PascalCase. Os seguintes valores são suportados.

  • Usuário
  • Group
  • Unidade Administrativa
  • Application
  • Dispositivo
  • Organization

Propriedades do parâmetro

Tipo:

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

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.