New-EntraBetaCustomSecurityAttributeDefinition

Módulo:
Microsoft.Entra.Beta.DirectoryManagement Module v1.3

Crie um novo objeto customSecurityAttributeDefinition.

Sintaxe

Default (Default) 

New-EntraBetaCustomSecurityAttributeDefinition

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

Description

O New-EntraBetaCustomSecurityAttributeDefinition cmdlet cria um novo objeto customSecurityAttributeDefinition. Especifique IsSearchable, IsCollectionAttributeSet, , Typee NameStatusUsePreDefinedValuesOnly parâmetros para criar uma nova definição de atributo de segurança personalizada.

Você pode definir até 500 objetos ativos em um locatário.

O usuário conectado deve receber uma das seguintes funções 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 o parâmetro especifica a descrição do atributo de segurança personalizado.
  • -Type o parâmetro especifica o tipo de dados para os valores de atributo de segurança personalizados.
  • -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 vários valores podem ser atribuídos ao atributo de segurança personalizado.
  • -IsSearchable O parâmetro especifica que os valores de atributo de segurança personalizados são indexados para pesquisa em objetos.
  • -UsePreDefinedValuesOnly O parâmetro especifica que os únicos valores predefinidos podem ser atribuídos ao atributo de segurança personalizado.

Parâmetros

-AttributeSet

Nome do conjunto de atributos. Não diferencia maiúsculas de minúsculas.

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

-Description

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

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

-IsCollection

Indica se vários valores podem ser atribuídos ao atributo de segurança personalizado. Não pode ser alterado mais tarde. Se o tipo for definido como Boolean, isCollection não poderá ser definido como true.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-IsSearchable

Indica se os valores de atributos de segurança personalizados estão indexados para pesquisa em objetos que são valores de atributo atribuídos. Não pode ser alterado mais tarde.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Name

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

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

-Status

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

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

-Type

Tipo de dados para os valores de atributos de segurança personalizados. Os tipos com suporte são: Boolean, Integer e String. Não pode ser alterado mais tarde.

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

-UsePreDefinedValuesOnly

Indica se apenas os valores predefinidos podem ser atribuídos ao atributo de segurança personalizado. Se definido como false, valores de forma livre serão permitidos. Posteriormente, pode ser alterado de true para false, mas não pode ser alterado de false para true. Se o tipo estiver definido como Boolean, usePreDefinedValuesOnly não poderá ser definido como true.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

Entradas

None

Saídas

System.Object