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.
-
-ApplicationIdO parâmetro especifica o identificador único de uma aplicação. -
-Nameparâ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.
-
-ApplicationIdO parâmetro especifica o identificador único de uma aplicação. -
-Nameparâmetro especifica o nome da propriedade de extensão. -
-DataTypeparâ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.
-
-ApplicationIdO parâmetro especifica o identificador único de uma aplicação. -
-Nameparâ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.