New-EntraBetaCustomSecurityAttributeDefinition

Erstellen Sie ein neues customSecurityAttributeDefinition-Objekt.

Syntax

Default (Standard)

New-EntraBetaCustomSecurityAttributeDefinition

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

Beschreibung

Das New-EntraBetaCustomSecurityAttributeDefinition Cmdlet erstellt ein neues customSecurityAttributeDefinition -Objekt. Geben Sie IsSearchable, IsCollection, , AttributeSet, TypeNameund UsePreDefinedValuesOnlyStatus Parameter zum Erstellen einer neuen benutzerdefinierten Sicherheitsattributedefinition an.

Sie können bis zu 500 aktive Objekte in einem Mandanten definieren.

Dem angemeldeten Benutzer muss eine der folgenden Verzeichnisrollen zugewiesen werden:

  • Attributdefinitionsadministrator

Beispiele

Beispiel 1: Hinzufügen eines benutzerdefinierten Sicherheitsattributes

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

In diesem Beispiel wird das Hinzufügen eines benutzerdefinierten Sicherheitsattributes veranschaulicht.

  • -Name der Parameter gibt den Namen des benutzerdefinierten Sicherheitsattributes an.
  • -Description der Parameter gibt die Beschreibung des benutzerdefinierten Sicherheitsattributes an.
  • -Type der Parameter gibt den Datentyp für die benutzerdefinierten Sicherheitsattributewerte an.
  • -Status Der Parameter gibt an, dass das benutzerdefinierte Sicherheitsattribute aktiv oder deaktiviert ist.
  • -AttributeSet der Parameter gibt den Namen des Attributsatzes an.
  • -IsCollection der Parameter gibt an, dass dem benutzerdefinierten Sicherheitsattribute mehrere Werte zugewiesen werden können.
  • -IsSearchable parameter specifies the custom security attribute values are indexed for searching on objects.
  • -UsePreDefinedValuesOnly Der Parameter gibt die einzigen vordefinierten Werte an, die dem benutzerdefinierten Sicherheitsattribute zugewiesen werden können.

Parameter

-AttributeSet

Name des Attributsatzes. Schreibungsunabhängig.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Description

Beschreibung des benutzerdefinierten Sicherheitsattributes, bis zu 128 Zeichen lang und einschließlich Unicode-Zeichen. Diese Beschreibung kann später geändert werden.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IsCollection

Gibt an, ob dem benutzerdefinierten Sicherheitsattribute mehrere Werte zugewiesen werden können. Kann später nicht mehr geändert werden. Wenn der Typ auf Boolean festgelegt ist, kann isCollection nicht auf "true" festgelegt werden.

Parametereigenschaften

Typ:System.Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IsSearchable

Gibt an, ob benutzerdefinierte Sicherheitsattributewerte für die Suche nach Objekten indiziert werden, denen Attributwerte zugewiesen sind. Kann später nicht mehr geändert werden.

Parametereigenschaften

Typ:System.Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Name des benutzerdefinierten Sicherheitsattributes. Muss innerhalb eines Attributsatzes eindeutig sein. Kann bis zu 32 Zeichen lang sein und Unicode-Zeichen enthalten. Darf keine Leerzeichen oder Sonderzeichen enthalten. Kann später nicht mehr geändert werden. Schreibungsunabhängig.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Status

Gibt an, ob das benutzerdefinierte Sicherheitsattribute aktiv oder deaktiviert ist. Zulässige Werte sind: Verfügbar und veraltet. Kann später geändert werden.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Type

Datentyp für die werte des benutzerdefinierten Sicherheitsattributes. Unterstützte Typen sind: Boolean, Integer und String. Kann später nicht mehr geändert werden.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UsePreDefinedValuesOnly

Gibt an, ob dem benutzerdefinierten Sicherheitsattribute nur vordefinierte Werte zugewiesen werden können. Wenn dieser Wert auf "false" festgelegt ist, sind Freiformwerte zulässig. Kann später von "true" in "false" geändert werden, kann aber nicht von "false" in "true" geändert werden. Wenn der Typ auf Boolean festgelegt ist, kann usePreDefinedValuesOnly nicht auf "true" festgelegt werden.

Parametereigenschaften

Typ:System.Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Ausgaben

System.Object