New-EntraApplicationExtensionProperty

Cria uma propriedade de extensão de aplicação.

Sintaxe

Default (Predefinição)

New-EntraApplicationExtensionProperty

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

Descrição

O New-EntraApplicationExtensionProperty cmdlet cria uma propriedade de extensão de aplicação para um objeto no 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 {}

Este comando cria uma propriedade de extensão de aplicação do tipo string para o objeto especificado.

  • -ApplicationId O parâmetro especifica o identificador único de uma aplicação.
  • -Name parâmetro especifica o nome da propriedade de extensão.

Exemplo 2: Criar uma propriedade de extensão com parâmetro de tipo de dado

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 cria uma propriedade de extensão de aplicação do tipo de dado especificado para o objeto especificado.

  • -ApplicationId O parâmetro especifica o identificador único de uma aplicação.
  • -Name parâmetro especifica o nome da propriedade de extensão.
  • -DataType parâmetro especifica o tipo de dado do valor que a propriedade de extensão pode conter.

Exemplo 3: Criar uma propriedade de extensão com 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 aplicação com os objetos-alvo especificados para o objeto especificado.

  • -ApplicationId O parâmetro especifica o identificador único de uma aplicação.
  • -Name parâmetro especifica o nome da propriedade de extensão.
  • -TargetObjectsparâmetro especifica os recursos Microsoft Graph que utilizam a propriedade de extensão. Todos os valores devem estar em PascalCase.

Parâmetros

-ApplicationId

Especifica um ID único de uma aplicação no Microsoft Entra ID.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:IdentificadorDoObjeto

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DataType

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

  • Binário - máximo 256 bytes
  • booleano
  • DataHora - Deve ser especificado no formato ISO 8601. Será armazenado no UTC.
  • Integer - valor de 32 bits.
  • LargeInteger - valor de 64 bits.
  • String - máximo 256 caracteres

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IsMultiValued

Especifica se a propriedade de extensão suporta múltiplos valores. Defina este parâmetro para $true se a propriedade de extensão puder conter múltiplos valores; caso contrário, defina para $false.

Propriedades dos parâmetros

Tipo:System.Boolean
Valor predefinido:False
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica o nome da propriedade de extensão.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-TargetObjects

Especifica os recursos Microsoft Graph que podem usar a propriedade de extensão. Todos os valores devem estar em PascalCase. São suportados os seguintes valores.

  • Utilizador
  • Group
  • Unidade Administrativa
  • Application
  • Dispositivo
  • Organization

Propriedades dos parâmetros

Tipo:

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

Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.