Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValue

Modul:
Microsoft.Entra.Beta.DirectoryManagement Module v1.3

Fügt einen vordefinierten Wert für eine benutzerdefinierte Sicherheitsattributedefinition hinzu.

Syntax

Default (Standard) 

Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValue

    -IsActive <Boolean>
    -CustomSecurityAttributeDefinitionId <String>
    -Id <String>
    [<CommonParameters>]

Beschreibung

Das Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValue Addiert einen vordefinierten Wert für eine Microsoft Entra ID benutzerdefinierte Sicherheitsattributedefinition.

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss der angemeldete Benutzer über eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit den erforderlichen Berechtigungen verfügen. Die folgenden am wenigsten privilegierten Rollen können verwendet werden:

  • Attributdefinitionsadministrator

Beispiele

Beispiel 1: Hinzufügen eines vordefinierten Werts für eine Microsoft Entra ID benutzerdefinierte Sicherheitsattributedefinition

Connect-Entra -Scopes 'CustomSecAttributeDefinition.ReadWrite.All'
$attributeDefinition = Get-EntraBetaCustomSecurityAttributeDefinition | Where-Object { $_.Name -eq 'Engineering' }
Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId $attributeDefinition.Id -Id 'Alpine' -IsActive $true

Id   IsActive
--   --------
Alpine True

In diesem Beispiel wird einer benutzerdefinierten Sicherheitsattributedefinition ein vordefinierter Wert hinzugefügt.

  • -CustomSecurityAttributeDefinitionId der Parameter gibt die benutzerdefinierte Sicherheitsattributedefinitions-ID an. Sie können den Befehl Get-EntraBetaCustomSecurityAttributeDefinition verwenden, um die ID abzurufen.
  • -Id der Parameter gibt den Bezeichner für den vordefinierten Wert an.
  • -IsActive Der Parameter gibt an, dass der vordefinierte Wert aktiv oder deaktiviert ist.

Parameter

-CustomSecurityAttributeDefinitionId

Der eindeutige Bezeichner für eine benutzerdefinierte Sicherheitsattributedefinition in Microsoft Entra ID.

Parametereigenschaften

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

Parametersätze

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

-Id

Der eindeutige Bezeichner für den vordefinierten Wert, der bis zu 64 Zeichen lang sein kann und Unicode-Zeichen enthalten kann. Leerzeichen sind zulässig, aber einige Sonderzeichen sind nicht zulässig. Bei diesem Bezeichner wird die Groß-/Kleinschreibung beachtet, kann später nicht geändert werden und ist erforderlich.

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

-IsActive

Gibt an, ob der vordefinierte Wert aktiv oder deaktiviert ist. Bei Festlegung auf "false" kann dieser vordefinierte Wert keinem anderen unterstützten Verzeichnisobjekt zugewiesen 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

System.String

Ausgaben

System.Object

Hinweise

Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValues ist ein Alias für Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValue.