Add-EntraCustomSecurityAttributeDefinitionAllowedValue

Adiciona um valor pré-definido para uma definição personalizada de atributo de segurança.

Sintaxe

Default (Predefinição)

Add-EntraCustomSecurityAttributeDefinitionAllowedValue

    -CustomSecurityAttributeDefinitionId <String>
    -Id <String>
    -IsActive <Boolean>
    [<CommonParameters>]

Descrição

Adiciona Add-EntraCustomSecurityAttributeDefinitionAllowedValue um valor pré-definido para uma definição personalizada de atributo de segurança do Microsoft Entra ID.

Em cenários delegados com contas de trabalho ou escola, o utilizador iniciado deve ter uma função Microsoft Entra suportada ou uma função personalizada com as permissões necessárias. Podem ser usados os seguintes papéis de menor privilégio:

  • Administrador de Definição de Atributo

Exemplos

Exemplo 1: Adicionar um valor pré-definido para uma definição personalizada de atributo de segurança do Microsoft Entra ID

Connect-Entra -Scopes 'CustomSecAttributeDefinition.ReadWrite.All'
$attributeDefinition = Get-EntraCustomSecurityAttributeDefinition | Where-Object {$_.Name -eq 'Engineering'}
Add-EntraCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId $attributeDefinition.Id -Id 'Alpine' -IsActive $true

Id   IsActive
--   --------
Alpine True

Este exemplo acrescenta um valor pré-definido a uma definição personalizada de atributo de segurança.

  • -CustomSecurityAttributeDefinitionId o parâmetro especifica o ID de definição do atributo de segurança personalizado. Podes usar o comando Get-EntraCustomSecurityAttributeDefinition para obter o ID.
  • -Id O parâmetro especifica o identificador para o valor pré-definido.
  • -IsActive o parâmetro especifica que o valor pré-definido está ativo ou desativado.

Parâmetros

-CustomSecurityAttributeDefinitionId

O identificador único para uma definição personalizada de atributo de segurança no Microsoft Entra ID.

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:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Id

O identificador único para o valor pré-definido, que pode ter até 64 caracteres e inclui caracteres Unicode. Espaços são permitidos, mas algumas personagens especiais não. Este identificador é distinto de maiúsculas e minúsculas, não pode ser alterado mais tarde e é obrigatório.

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:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IsActive

Indica se o valor pré-definido está ativo ou desativado. Se definido como falso, este valor pré-definido não pode ser atribuído a outros objetos de diretório suportados.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
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.

Entradas

System.String

Saídas

System.Object

Notas

Add-EntraCustomSecurityAttributeDefinitionAllowedValues é um alias para Add-EntraCustomSecurityAttributeDefinitionAllowedValue.