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
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.