New-EntraBetaCustomSecurityAttributeDefinition

Crie um novo objeto customSecurityAttributeDefinition.

Sintaxe

Default (Predefinição)

New-EntraBetaCustomSecurityAttributeDefinition

    -IsSearchable <Boolean>
    -IsCollection <Boolean>
    -AttributeSet <String>
    -Type <String>
    -Name <String>
    -Status <String>
    -UsePreDefinedValuesOnly <Boolean>
    [-Description <String>]
    [<CommonParameters>]

Descrição

O New-EntraBetaCustomSecurityAttributeDefinition cmdlet cria um novo objeto customSecurityAttributeDefinition. Especifique IsSearchable, IsCollection, AttributeSet, Type, Name, e StatusUsePreDefinedValuesOnly parâmetros para criar uma nova definição personalizada de atributo de segurança.

Podes definir até 500 objetos ativos num inquilino.

O utilizador iniciado sessão deve ser atribuído a um dos seguintes papéis de diretório:

  • Administrador de Definição de Atributo

Exemplos

Exemplo 1: Adicionar um atributo de segurança personalizado

Connect-Entra -Scopes 'CustomSecAttributeDefinition.Read.All', 'CustomSecAttributeDefinition.ReadWrite.All'
$attributeSet = Get-EntraAttributeSet -Id 'ContosoSet'
$params = @{
    Name                    = 'ProjectTest'
    Description             = 'Target completion'
    Type                    = 'String'
    Status                  = 'Available'
    AttributeSet            = $attributeSet.Id
    IsCollection            = $False
    IsSearchable            = $True
    UsePreDefinedValuesOnly = $True
}
New-EntraBetaCustomSecurityAttributeDefinition @params
Id               AttributeSet Description       IsCollection IsSearchable Name        Status    Type   UsePreDefinedValuesOnly
--               ------------ -----------       ------------ ------------ ----        ------    ----   -----------------------
Test_ProjectTest Test         Target completion False        True         ProjectTest Available String False

Este exemplo demonstra como adicionar um atributo de segurança personalizado.

  • -Name o parâmetro especifica o nome do atributo de segurança personalizado.
  • -Description parâmetro especifica a descrição do atributo de segurança personalizado.
  • -Type O parâmetro especifica o tipo de dado para os valores personalizados do atributo de segurança.
  • -Status O parâmetro especifica que o atributo de segurança personalizado está ativo ou desativado.
  • -AttributeSet O parâmetro especifica o nome do conjunto de atributos.
  • -IsCollection O parâmetro especifica que permite que múltiplos valores possam ser atribuídos ao atributo de segurança personalizado.
  • -IsSearchable Parameter especifica que os valores personalizados dos atributos de segurança são indexados para pesquisa em objetos.
  • -UsePreDefinedValuesOnly O parâmetro especifica que os únicos valores pré-definidos podem ser atribuídos ao atributo de segurança personalizado.

Parâmetros

-AttributeSet

Nome do conjunto de atributos. Insensível a maiúsculas e minúsculas.

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

-Description

Descrição do atributo de segurança personalizado, com até 128 caracteres e incluindo caracteres Unicode. Esta descrição pode ser alterada mais tarde.

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

-IsCollection

Indica se vários valores podem ser atribuídos ao atributo de segurança personalizado. Não pode ser alterado depois. Se o type estiver definido como Booleano, isCollection não pode ser definido como true.

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

-IsSearchable

Indica se valores personalizados de atributos de segurança estão indexados para pesquisa em objetos que recebem valores de atributo. Não pode ser alterado depois.

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

-Name

Nome do atributo de segurança personalizado. Deve ser exclusivo dentro de um conjunto de atributos. Pode ter até 32 caracteres e incluir caracteres Unicode. Não pode conter espaços ou caracteres especiais. Não pode ser alterado depois. Insensível a maiúsculas e minúsculas.

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

-Status

Especifica se o atributo de segurança personalizado está ativo ou desativado. Os valores aceitáveis são: Disponível e Descontinuado. Pode ser alterado mais tarde.

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

-Type

Tipo de dados para os valores de atributos de segurança personalizados. Os tipos suportados são: Booleano, Inteiro e String. Não pode ser alterado depois.

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

-UsePreDefinedValuesOnly

Indica se apenas valores predefinidos podem ser atribuídos ao atributo de segurança personalizado. Se definido como falso, são permitidos valores de forma livre. Mais tarde, pode ser alterado de verdadeiro para falso, mas não pode ser alterado de falso para verdadeiro. Se o tipo estiver definido como Booleano, o usePreDefinedValuesOnly não pode ser definido como verdadeiro.

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

None

Saídas

System.Object