Hinzufügen oder Deaktivieren von Definitionen benutzerdefinierter Sicherheitsattribute in Microsoft Entra ID

Artikel
11/15/2023

Benutzerdefinierte Sicherheitsattribute in Microsoft Entra ID sind geschäftsspezifische Attribute (Schlüssel-Wert-Paare), die Sie definieren und Microsoft Entra-Objekten zuweisen können. In diesem Artikel wird beschrieben, wie Definitionen benutzerdefinierter Sicherheitsattribute hinzugefügt, bearbeitet oder deaktiviert werden.

Voraussetzungen

Zum Hinzufügen oder Deaktivieren von Definitionen benutzerdefinierter Sicherheitsattribute benötigen Sie Folgendes:

Administrator für Attributdefinitionen
Microsoft.Graph-Modul bei Verwendung von Microsoft Graph-PowerShell
AzureADPreview (ab Version 2.0.2.138) bei Verwendung von Azure AD PowerShell

Wichtig

Standardmäßig verfügen globale Administratoren und andere Administratorrollen nicht über Berechtigungen zum Lesen, Definieren oder Zuweisen von benutzerdefinierten Sicherheitsattributen.

Hinzufügen eines Attributsatzes

Tipp

Die Schritte in diesem Artikel können je nach dem Portal, mit dem Sie beginnen, geringfügig variieren.

Ein Attributsatz ist eine Sammlung von zusammengehörigen Attributen. Jedes benutzerdefinierte Sicherheitsattribut muss Teil eines Attributsatzes sein. Attributsätze können nicht umbenannt oder gelöscht werden.

Melden Sie sich beim Microsoft Entra-Admin Center als Administrator für Attributdefinition an.
Navigieren Sie zu Schutz>Benutzerdefinierte Sicherheitsattribute.
Klicken Sie auf Attributsatz Hinzufügen, um einen neuen Attributsatz hinzuzufügen.

Falls Attributsatz Hinzufügen deaktiviert ist, stellen Sie sicher, dass Ihnen die Rolle als Attributdefinitions-Administrator zugewiesen ist. Weitere Informationen finden Sie unter Problembehandlung bei benutzerdefinierten Sicherheitsattributen.
Geben Sie einen Namen, eine Beschreibung und die maximale Anzahl von Attributen ein.

Ein Attributsatzname kann bis zu 32 Zeichen ohne Leerzeichen oder Sonderzeichen enthalten. Nachdem Sie einen Namen angegeben haben, können Sie ihn nicht mehr umbenennen. Weitere Details finden Sie im Abschnitt Limits und Einschränkungen.
Klicken Sie abschließend auf Hinzufügen.

Der neue Attributsatz wird in der Liste der Attributsätze angezeigt.

Hinzufügen einer Definition benutzerdefinierter Sicherheitsattribute

Melden Sie sich beim Microsoft Entra-Admin Center als Administrator für Attributdefinition an.
Navigieren Sie zu Schutz>Benutzerdefinierte Sicherheitsattribute.
Suchen Sie auf der Seite Benutzerdefinierte Sicherheitsattribute nach einem vorhandenen Attributsatz, oder klicken Sie auf Attributsatz hinzufügen, um einen neuen Attributsatz hinzuzufügen.

Alle Definitionen benutzerdefinierter Sicherheitsattribute müssen Teil eines Attributsatzes sein.
Klicken Sie auf diese Option, um den ausgewählten Attributsatz zu öffnen.
Klicken Sie auf Attribut hinzufügen, um dem Attributsatz ein neues benutzerdefiniertes Sicherheitsattribut hinzuzufügen.
Wählen Sie unter Attributname ein benutzerdefiniertes Sicherheitsattribut aus der Liste aus.

Ein benutzerdefiniertes Sicherheitsattribut kann bis zu 32 Zeichen ohne Leerzeichen oder Sonderzeichen enthalten. Nachdem Sie einen Namen angegeben haben, können Sie ihn nicht mehr umbenennen. Weitere Details finden Sie im Abschnitt Limits und Einschränkungen.
Geben Sie im Textfeld Beschreibung eine optionale Beschreibung ein.

Die Beschreibung kann Zeichen umfassen. Bei Bedarf können Sie die Beschreibung später ändern.

Wählen Sie in der Liste Datentyp den Datentyp für das benutzerdefinierte Sicherheitsattribut aus.

Datentyp	Beschreibung
Boolesch	Ein boolescher Wert, der true, TRUE, false oder FALSE sein kann.
Ganze Zahl	Eine 32-Bit-Ganzzahl.
Zeichenfolge	Eine Zeichenfolge, die X Zeichen lang sein kann.

Wählen Sie für Zuweisung mehrerer Werte zulassen, Ja oder Nein.

Wählen Sie Ja, damit diesem benutzerdefinierten Sicherheitsattribut mehrere Werte zugewiesen werden können. Wählen Sie Ja, damit diesem benutzerdefinierten Sicherheitsattribut mehrere Werte zugewiesen werden können.
Wählen Sie für Nur die Zuweisung von vordefinierten Werten zulassen, Ja oder Nein.

Wählen Sie Ja aus, um zu verlangen, dass diesem benutzerdefinierten Sicherheitsattribut Werte aus einer vordefinierten Werteliste zugewiesen werden. Wählen Sie Nein, um zuzulassen, dass diesem benutzerdefinierten Sicherheitsattribut benutzerdefinierte Werte oder potenziell vordefinierte Werte zugewiesen werden.
Wenn Nur die Zuweisung von vordefinierten Werten ZulassenJa ist, klicken Sie auf Wert hinzufügen, um vordefinierte Werte hinzuzufügen.

Ein aktiver Wert ist für die Zuweisung zu Objekten verfügbar. Ein Wert, der nicht aktiv ist, ist definiert, aber noch nicht für die Zuweisung verfügbar.
Klicken Sie abschließend auf Speichern.

Das neue benutzerdefinierte Sicherheitsattribut wird in der Liste der benutzerdefinierten Sicherheitsattribute angezeigt.
Wenn Sie vordefinierte Werte einschließen möchten, führen Sie die Schritte im nächsten Abschnitt aus.

Bearbeiten einer Definition benutzerdefinierter Sicherheitsattribute

Nachdem Sie eine neue Definition benutzerdefinierter Sicherheitsattribute hinzugefügt haben, können Sie später einige der Eigenschaften bearbeiten. Einige Eigenschaften sind unveränderlich und können später nicht mehr geändert werden.

Melden Sie sich beim Microsoft Entra-Admin Center als Administrator für Attributdefinition an.
Navigieren Sie zu Schutz>Benutzerdefinierte Sicherheitsattribute.
Klicken Sie auf den Attributsatz, der das benutzerdefinierte Sicherheitsattribut enthält, das Sie bearbeiten möchten.
Wählen Sie in der Liste der benutzerdefinierten Sicherheitsattribute das Auslassungszeichen für das benutzerdefinierte Sicherheitsattribut aus, das Sie bearbeiten möchten, und wählen Sie dann Attribut bearbeiten aus.
Bearbeiten Sie die aktivierten Eigenschaften.
Wenn Nur die Zuweisung von vordefinierten Werten ZulassenJa ist, klicken Sie auf Wert hinzufügen, um vordefinierte Werte hinzuzufügen. Klicken Sie auf einen vorhandenen vordefinierten Wert, um die Einstellung Ist aktiv? zu ändern.

Deaktivieren einer Definition benutzerdefinierter Sicherheitsattribute

Nachdem Sie eine Definition benutzerdefinierter Sicherheitsattribute hinzugefügt haben, können Sie sie nicht mehr löschen. Sie können eine Definition benutzerdefinierter Sicherheitsattribute jedoch deaktivieren.

Melden Sie sich beim Microsoft Entra-Admin Center als Administrator für Attributdefinition an.
Navigieren Sie zu Schutz>Benutzerdefinierte Sicherheitsattribute.
Klicken Sie auf den Attributsatz, der das benutzerdefinierte Sicherheitsattribut enthält, das Sie deaktivieren möchten.
Fügen Sie in der Liste der benutzerdefinierten Sicherheitsattribute ein Häkchen neben dem benutzerdefinierten Sicherheitsattribut hinzu, das Sie deaktivieren möchten.
Klicken Sie auf Attribut Deaktivieren.
Klicken Sie im eingeblendeten Dialogfeld Attribut Deaktivieren auf Ja.

Das benutzerdefinierte Sicherheitsattribut wird deaktiviert und in die Liste Deaktivierte Attribute verschoben.

PowerShell oder Microsoft Graph-API

Zum Verwalten von Definitionen benutzerdefinierter Sicherheitsattribute in Ihrer Microsoft Entra-Organisation können Sie auch PowerShell oder die Microsoft Graph-API verwenden. In den folgenden Beispielen werden Attributsätze und Definitionen benutzerdefinierter Sicherheitsattribute verwaltet.

Abrufen aller Attributsätze

Im folgenden Beispiel werden alle Attributsätze abgerufen.

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet | Format-List

Description          : Attributes for engineering team
Id                   : Engineering
MaxAttributesPerSet  : 25
AdditionalProperties : {}

Description          : Attributes for marketing team
Id                   : Marketing
MaxAttributesPerSet  : 25
AdditionalProperties : {}

Auflisten von „attributeSets“

GET https://graph.microsoft.com/v1.0/directory/attributeSets

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet

Abrufen der obersten Attributsätze

Im folgenden Beispiel werden die obersten Attributsätze abgerufen.

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Top 10

Auflisten von „attributeSets“

GET https://graph.microsoft.com/v1.0/directory/attributeSets?$top=10

Abrufen von Attributsätzen in der Reihenfolge

Im folgenden Beispiel werden Attributsätze der Reihe nach abgerufen.

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Sort "Id"

Auflisten von „attributeSets“

GET https://graph.microsoft.com/v1.0/directory/attributeSets?$orderBy=id

Abrufen eines Attributsatzes

Im folgenden Beispiel wird ein Attributsatz abgerufen.

Attributsatz: Engineering

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -AttributeSetId "Engineering" | Format-List

Description          : Attributes for engineering team
Id                   : Engineering
MaxAttributesPerSet  : 25
AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/attributeSets/$entity]}

Abrufen von „attributeSet“

GET https://graph.microsoft.com/v1.0/directory/attributeSets/Engineering

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet -Id "Engineering"

Hinzufügen eines Attributsatzes

Im folgenden Beispiel wird ein neuer Attributsatz hinzugefügt.

Attributsatz: Engineering

New-MgDirectoryAttributeSet

$params = @{
    Id = "Engineering"
    Description = "Attributes for engineering team"
    MaxAttributesPerSet = 25
}
New-MgDirectoryAttributeSet -BodyParameter $params

Id          Description                     MaxAttributesPerSet
--          -----------                     -------------------
Engineering Attributes for engineering team 25

Erstellen von „attributeSet“

POST https://graph.microsoft.com/v1.0/directory/attributeSets 
{
    "id":"Engineering",
    "description":"Attributes for engineering team",
    "maxAttributesPerSet":25
}

New-AzureADMSAttributeSet

New-AzureADMSAttributeSet -Id "Engineering" -Description "Attributes for engineering team" -MaxAttributesPerSet 10

Aktualisierung eines Attributsatzes

Im folgenden Beispiel wird ein Attributsatz aktualisiert.

Attributsatz: Engineering

Update-MgDirectoryAttributeSet

$params = @{
    description = "Attributes for engineering team"
    maxAttributesPerSet = 20
}
Update-MgDirectoryAttributeSet -AttributeSetId "Engineering" -BodyParameter $params

Aktualisieren von „attributeSet“

PATCH https://graph.microsoft.com/v1.0/directory/attributeSets/Engineering
{
    "description":"Attributes for engineering team",
    "maxAttributesPerSet":20
}

Set-AzureADMSAttributeSet

Set-AzureADMSAttributeSet -Id "Engineering" -Description "Attributes for cloud engineering team"
Set-AzureADMSAttributeSet -Id "Engineering" -MaxAttributesPerSet 20

Abrufen aller Definitionen benutzerdefinierter Sicherheitsattribute

Im folgenden Beispiel werden alle Definitionen benutzerdefinierter Sicherheitsattribute abgerufen.

Get-MgDirectoryCustomSecurityAttributeDefinition

Get-MgDirectoryCustomSecurityAttributeDefinition | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Target completion date
Id                      : Engineering_ProjectDate
IsCollection            : False
IsSearchable            : True
Name                    : ProjectDate
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : False
AdditionalProperties    : {}

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {}

AllowedValues           :
AttributeSet            : Marketing
Description             : Country where is application is used
Id                      : Marketing_AppCountry
IsCollection            : True
IsSearchable            : True
Name                    : AppCountry
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {}

Auflisten von „customSecurityAttributeDefinitions“

GET https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition

Filtern von Definitionen benutzerdefinierter Sicherheitsattribute

In den folgenden Beispielen werden Definitionen benutzerdefinierter Sicherheitsattribute gefiltert.

Filtern: Attributname ist gleich 'Projekt' und Status ist gleich 'Verfügbar'

Get-MgDirectoryCustomSecurityAttributeDefinition

Get-MgDirectoryCustomSecurityAttributeDefinition -Filter "name eq 'Project' and status eq 'Available'" | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {}

Auflisten von „customSecurityAttributeDefinitions“

GET https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions?$filter=name+eq+'Project'%20and%20status+eq+'Available'

Filter: Attributset gleich 'Engineering' und Status gleich 'Verfügbar' und Datentyp gleich 'Zeichenkette'

Get-MgDirectoryCustomSecurityAttributeDefinition

Get-MgDirectoryCustomSecurityAttributeDefinition -Filter "attributeSet eq 'Engineering' and status eq 'Available' and type eq 'String'" | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Target completion date
Id                      : Engineering_ProjectDate
IsCollection            : False
IsSearchable            : True
Name                    : ProjectDate
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : False
AdditionalProperties    : {}

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {}

Auflisten von „customSecurityAttributeDefinitions“

GET https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions?$filter=attributeSet+eq+'Engineering'%20and%20status+eq+'Available'%20and%20type+eq+'String'

Abrufen einer Definition benutzerdefinierter Sicherheitsattribute

Im folgenden Beispiel wird eine Definition benutzerdefinierter Sicherheitsattribute abgerufen.

Attributsatz: Engineering
Attribut: ProjectDate

Get-MgDirectoryCustomSecurityAttributeDefinition

Get-MgDirectoryCustomSecurityAttributeDefinition -CustomSecurityAttributeDefinitionId "Engineering_ProjectDate" | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Target completion date
Id                      : Engineering_ProjectDate
IsCollection            : False
IsSearchable            : True
Name                    : ProjectDate
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : False
AdditionalProperties    : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions/$entity]}

Abrufen von „customSecurityAttributeDefinition“

GET https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_ProjectDate

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition -Id "Engineering_ProjectDate"

Hinzufügen einer Definition benutzerdefinierter Sicherheitsattribute

Im folgenden Beispiel wird eine neue Definition benutzerdefinierter Sicherheitsattribute hinzugefügt.

Attributsatz: Engineering
Attribut: ProjectDate
Attributdatentyp: Zeichenfolge

New-MgDirectoryCustomSecurityAttributeDefinition

$params = @{
    attributeSet = "Engineering"
    description = "Target completion date"
    isCollection = $false
    isSearchable = $true
    name = "ProjectDate"
    status = "Available"
    type = "String"
    usePreDefinedValuesOnly = $false
}
New-MgDirectoryCustomSecurityAttributeDefinition -BodyParameter $params | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Target completion date
Id                      : Engineering_ProjectDate
IsCollection            : False
IsSearchable            : True
Name                    : ProjectDate
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : False
AdditionalProperties    : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions/$entity]}

Erstellen von „customSecurityAttributeDefinition“

POST https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions
{
    "attributeSet":"Engineering",
    "description":"Target completion date",
    "isCollection":false,
    "isSearchable":true,
    "name":"ProjectDate",
    "status":"Available",
    "type":"String",
    "usePreDefinedValuesOnly": false
}

New-AzureADMSCustomSecurityAttributeDefinition

New-AzureADMSCustomSecurityAttributeDefinition -AttributeSet "Engineering" -Name "ProjectDate" -Description "Target completion date" -Type "String" -Status "Available" -IsCollection $false -IsSearchable $true -UsePreDefinedValuesOnly $false

Hinzufügen einer Definition benutzerdefinierter Sicherheitsattribute, die mehrere vordefinierte Werte unterstützt

Im folgenden Beispiel wird eine neue Definition benutzerdefinierter Sicherheitsattribute hinzugefügt, die mehrere vordefinierte Werte unterstützt.

Attributsatz: Engineering
Attribut: Project
Attributdatentyp: Auflistung von Zeichenfolgen

New-MgDirectoryCustomSecurityAttributeDefinition

$params = @{
    attributeSet = "Engineering"
    description = "Active projects for user"
    isCollection = $true
    isSearchable = $true
    name = "Project"
    status = "Available"
    type = "String"
    usePreDefinedValuesOnly = $true
}
New-MgDirectoryCustomSecurityAttributeDefinition -BodyParameter $params | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions/$entity]}

Erstellen von „customSecurityAttributeDefinition“

POST https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions
{
    "attributeSet":"Engineering",
    "description":"Active projects for user",
    "isCollection":true,
    "isSearchable":true,
    "name":"Project",
    "status":"Available",
    "type":"String",
    "usePreDefinedValuesOnly": true
}

Hinzufügen einer Definition benutzerdefinierter Sicherheitsattribute mit einer Liste von vordefinierten Werten

Im folgenden Beispiel wird eine neue Definition benutzerdefinierter Sicherheitsattribute mit einer Liste von vordefinierten Werten hinzugefügt.

Attributsatz: Engineering
Attribut: Project
Attributdatentyp: Auflistung von Zeichenfolgen
Vordefinierte Werte: Alpine, Baker, Cascade

New-MgDirectoryCustomSecurityAttributeDefinition

$params = @{
    attributeSet = "Engineering"
    description = "Active projects for user"
    isCollection = $true
    isSearchable = $true
    name = "Project"
    status = "Available"
    type = "String"
    usePreDefinedValuesOnly = $true
    allowedValues = @(
        @{
            id = "Alpine"
            isActive = $true
        }
        @{
            id = "Baker"
            isActive = $true
        }
        @{
            id = "Cascade"
            isActive = $true
        }
    )
}
New-MgDirectoryCustomSecurityAttributeDefinition -BodyParameter $params | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions/$entity]}

Erstellen von „customSecurityAttributeDefinition“

POST https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions
{
    "attributeSet": "Engineering",
    "description": "Active projects for user",
    "isCollection": true,
    "isSearchable": true,
    "name": "Project",
    "status": "Available",
    "type": "String",
    "usePreDefinedValuesOnly": true,
    "allowedValues": [
        {
            "id": "Alpine",
            "isActive": true
        },
        {
            "id": "Baker",
            "isActive": true
        },
        {
            "id": "Cascade",
            "isActive": true
        }
    ]
}

Aktualisieren einer Definition benutzerdefinierter Sicherheitsattribute

Im folgenden Beispiel wird eine Definition benutzerdefinierter Sicherheitsattribute aktualisiert.

Attributsatz: Engineering
Attribut: ProjectDate

Update-MgDirectoryCustomSecurityAttributeDefinition

$params = @{
    description = "Target completion date (YYYY/MM/DD)"
}
Update-MgDirectoryCustomSecurityAttributeDefinition -CustomSecurityAttributeDefinitionId "Engineering_ProjectDate" -BodyParameter $params

Aktualisieren von „customSecurityAttributeDefinition“

PATCH https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_ProjectDate
{
  "description": "Target completion date (YYYY/MM/DD)",
}

Set-AzureADMSCustomSecurityAttributeDefinition

Set-AzureADMSCustomSecurityAttributeDefinition -Id "Engineering_ProjectDate" -Description "Target completion date (YYYY/MM/DD)"

Aktualisieren der vordefinierten Werte für eine Definition benutzerdefinierter Sicherheitsattribute

Im folgenden Beispiel werden die vordefinierten Werte für eine Definition benutzerdefinierter Sicherheitsattribute aktualisiert.

Attributsatz: Engineering
Attribut: Project
Attributdatentyp: Auflistung von Zeichenfolgen
Vordefinierten Wert aktualisieren: Baker
Neuer vordefinierter Wert: Skagit

Invoke-MgGraphRequest

Hinweis

Für diese Anforderung müssen Sie den OData-Version-Header hinzufügen und ihm den Wert 4.01 zuweisen.

$params = @{
    "allowedValues@delta" = @(
        @{
            id = "Baker"
            isActive = $false
        }
        @{
            id = "Skagit"
            isActive = $true
        }
    )
}
$header = @{
    "OData-Version" = 4.01
}
Invoke-MgGraphRequest -Method PATCH -Uri "https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project5" -Headers $header -Body $params

Aktualisieren von „customSecurityAttributeDefinition“

Hinweis

Für diese Anforderung müssen Sie den OData-Version-Header hinzufügen und ihm den Wert 4.01 zuweisen.

PATCH https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project
{
    "allowedValues@delta": [
        {
            "id": "Baker",
            "isActive": false
        },
        {
            "id": "Skagit",
            "isActive": true
        }
    ]
}

Deaktivieren einer Definition benutzerdefinierter Sicherheitsattribute

Im folgenden Beispiel wird eine Definition benutzerdefinierter Sicherheitsattribute deaktiviert.

Attributsatz: Engineering
Attribut: Project

Update-MgDirectoryCustomSecurityAttributeDefinition

$params = @{
    status = "Deprecated"
}
Update-MgDirectoryCustomSecurityAttributeDefinition -CustomSecurityAttributeDefinitionId "Engineering_ProjectDate" -BodyParameter $params

Aktualisieren von „customSecurityAttributeDefinition“

PATCH https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project
{
  "status": "Deprecated"
}

Set-AzureADMSCustomSecurityAttributeDefinition

Set-AzureADMSCustomSecurityAttributeDefinition -Id "Engineering_Project" -Status "Deprecated"

Abrufen aller vordefinierten Werte

Im folgenden Beispiel werden alle vordefinierten Werte für eine Definition benutzerdefinierter Sicherheitsattribute abgerufen.

Attributsatz: Engineering
Attribut: Project

Get-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

Get-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" | Format-List

Id                   : Skagit
IsActive             : True
AdditionalProperties : {}

Id                   : Baker
IsActive             : False
AdditionalProperties : {}

Id                   : Cascade
IsActive             : True
AdditionalProperties : {}

Id                   : Alpine
IsActive             : True
AdditionalProperties : {}

Auflisten von „allowedValues“

GET https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project/allowedValues

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project"

Abrufen eines vordefinierten Wertes

Im folgenden Beispiel wird ein vordefinierter Wert für eine Definition benutzerdefinierter Sicherheitsattribute abgerufen.

Attributsatz: Engineering
Attribut: Project
Vordefinierter Wert: Alpine

Get-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

Get-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -AllowedValueId "Alpine" | Format-List

Id                   : Alpine
IsActive             : True
AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions('Engineering_Project')/al
                       lowedValues/$entity]}

Abrufen von „allowedValue“

GET https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project/allowedValues/Alpine

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -Id "Alpine"

Einen vordefinierten Wert hinzufügen

Im folgenden Beispiel wird ein vordefinierter Wert für eine Definition benutzerdefinierter Sicherheitsattribute hinzugefügt.

Sie können vordefinierte Werte für benutzerdefinierte Sicherheitsattribute hinzufügen, die usePreDefinedValuesOnly auf true gesetzt sind.

Attributsatz: Engineering
Attribut: Project
Vordefinierter Wert: Alpine

New-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

$params = @{
    id = "Alpine"
    isActive = $true
}
New-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -BodyParameter $params | Format-List

Id                   : Alpine
IsActive             : True
AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions('Engineering_Project')/al
                       lowedValues/$entity]}

Erstellen von „allowedValue“

POST https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project/allowedValues
{
    "id":"Alpine",
    "isActive":"true"
}

Add-AzureADMScustomSecurityAttributeDefinitionAllowedValues

Add-AzureADMScustomSecurityAttributeDefinitionAllowedValues -CustomSecurityAttributeDefinitionId "Engineering_Project" -Id "Alpine" -IsActive $true

Deaktivieren eines vordefinierten Werts

Im folgenden Beispiel wird ein vordefinierter Wert für eine Definition benutzerdefinierter Sicherheitsattribute deaktiviert.

Attributsatz: Engineering
Attribut: Project
Vordefinierter Wert: Alpine

Update-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

$params = @{
    isActive = $false
}
Update-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -AllowedValueId "Alpine" -BodyParameter $params

Aktualisieren von „allowedValue“

PATCH https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project/allowedValues/Alpine
{
    "isActive":"false"
}

Set-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

Set-AzureADMSCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -Id "Alpine" -IsActive $false

Häufig gestellte Fragen

Kann man benutzerdefinierte Definitionen von Sicherheitsattributen löschen?

Nein, man kann benutzerdefinierte Definitionen von Sicherheitsattributen nicht löschen. Man kann benutzerdefinierte Definitionen von Sicherheitsattributen lediglich deaktivieren. Nachdem Sie ein benutzerdefiniertes Sicherheitsattribut deaktiviert haben, kann es nicht mehr auf Microsoft Entra-Objekte angewendet werden. Benutzerdefinierte Sicherheitsattributzuweisungen für die deaktivierte benutzerdefinierte Sicherheitsattributdefinition werden nicht automatisch entfernt. Es gibt keine Beschränkung für die Anzahl deaktivierter benutzerdefinierter Sicherheitsattribute. Sie können über 500 aktive benutzerdefinierte Sicherheitsattributdefinitionen pro Mandant mit 100 zulässigen vordefinierten Werten pro benutzerdefinierter Sicherheitsattributdefinition verfügen.

Hinzufügen oder Deaktivieren von Definitionen benutzerdefinierter Sicherheitsattribute in Microsoft Entra ID

Voraussetzungen

Hinzufügen eines Attributsatzes

Hinzufügen einer Definition benutzerdefinierter Sicherheitsattribute

Bearbeiten einer Definition benutzerdefinierter Sicherheitsattribute

Deaktivieren einer Definition benutzerdefinierter Sicherheitsattribute

PowerShell oder Microsoft Graph-API

Abrufen aller Attributsätze

Abrufen der obersten Attributsätze

Abrufen von Attributsätzen in der Reihenfolge

Abrufen eines Attributsatzes

Hinzufügen eines Attributsatzes

Aktualisierung eines Attributsatzes

Abrufen aller Definitionen benutzerdefinierter Sicherheitsattribute

Filtern von Definitionen benutzerdefinierter Sicherheitsattribute

Abrufen einer Definition benutzerdefinierter Sicherheitsattribute

Hinzufügen einer Definition benutzerdefinierter Sicherheitsattribute

Hinzufügen einer Definition benutzerdefinierter Sicherheitsattribute, die mehrere vordefinierte Werte unterstützt

Hinzufügen einer Definition benutzerdefinierter Sicherheitsattribute mit einer Liste von vordefinierten Werten

Aktualisieren einer Definition benutzerdefinierter Sicherheitsattribute

Aktualisieren der vordefinierten Werte für eine Definition benutzerdefinierter Sicherheitsattribute

Deaktivieren einer Definition benutzerdefinierter Sicherheitsattribute

Abrufen aller vordefinierten Werte

Abrufen eines vordefinierten Wertes

Einen vordefinierten Wert hinzufügen

Deaktivieren eines vordefinierten Werts

Häufig gestellte Fragen

Nächste Schritte

Zusätzliche Ressourcen