New-EntraBetaCustomSecurityAttributeDefinition

Créez un objet customSecurityAttributeDefinition.

Syntaxe

Default (Par défaut)

New-EntraBetaCustomSecurityAttributeDefinition

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

Description

L’applet New-EntraBetaCustomSecurityAttributeDefinition de commande crée un objet customSecurityAttributeDefinition. Spécifiez , , IsCollectionAttributeSet, Type, StatusNameet UsePreDefinedValuesOnly les IsSearchableparamètres pour créer une définition d’attribut de sécurité personnalisée.

Vous pouvez définir jusqu’à 500 objets actifs dans un locataire.

L’utilisateur connecté doit être affecté à l’un des rôles d’annuaire suivants :

  • Administrateur de définition d’attribut

Exemples

Exemple 1 : Ajouter un attribut de sécurité personnalisé

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

Cet exemple montre comment ajouter un attribut de sécurité personnalisé.

  • -Name spécifie le nom de l’attribut de sécurité personnalisé.
  • -Description spécifie la description de l’attribut de sécurité personnalisé.
  • -Type spécifie le type de données pour les valeurs d’attribut de sécurité personnalisées.
  • -Status spécifie que l’attribut de sécurité personnalisé est actif ou désactivé.
  • -AttributeSet spécifie le nom du jeu d’attributs.
  • -IsCollection spécifie que plusieurs valeurs peuvent être affectées à l’attribut de sécurité personnalisé.
  • -IsSearchable spécifie les valeurs d’attribut de sécurité personnalisées sont indexées pour la recherche sur les objets.
  • -UsePreDefinedValuesOnly spécifie les seules valeurs prédéfinies qui peuvent être affectées à l’attribut de sécurité personnalisé.

Paramètres

-AttributeSet

Nom du jeu d’attributs. Respect de la casse.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Description

Description de l’attribut de sécurité personnalisé, jusqu’à 128 caractères longs et incluant des caractères Unicode. Cette description peut être modifiée ultérieurement.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IsCollection

Indique si plusieurs valeurs peuvent être attribuées à l’attribut de sécurité personnalisé. Ne peut pas être modifié ultérieurement. Si le type est défini sur Boolean, isCollection ne peut pas être défini sur true.

Propriétés du paramètre

Type:System.Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IsSearchable

Indique si les valeurs d’attribut de sécurité personnalisées sont indexées pour la recherche sur les objets auxquels des valeurs d’attribut sont attribuées. Ne peut pas être modifié ultérieurement.

Propriétés du paramètre

Type:System.Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Nom de l’attribut de sécurité personnalisé. Doit être unique dans un jeu d’attributs. Peut contenir jusqu’à 32 caractères et inclure des caractères Unicode. Ne peut pas contenir d’espaces ou de caractères spéciaux. Ne peut pas être modifié ultérieurement. Respect de la casse.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Status

Spécifie si l’attribut de sécurité personnalisé est actif ou désactivé. Les valeurs acceptables sont : Disponibles et déconseillées. Peut être modifié ultérieurement.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Type

Type de données pour les valeurs des attributs de sécurité personnalisés. Les types pris en charge sont les suivants : Boolean, Integer et String. Ne peut pas être modifié ultérieurement.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-UsePreDefinedValuesOnly

Indique si seules des valeurs prédéfinies peuvent être attribuées à l’attribut de sécurité personnalisé. Si la valeur est false, les valeurs de forme libre sont autorisées. Peut ensuite être changé de true à false, mais ne peut pas être changé de false à true. Si le type est défini sur Boolean, usePreDefinedValuesOnly ne peut pas être défini sur true.

Propriétés du paramètre

Type:System.Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

None

Sorties

System.Object