Microsoft Entra Id'de özel güvenlik özniteliği tanımlarını ekleme veya devre dışı bırakma

Microsoft Entra Id'deki özel güvenlik öznitelikleri , Microsoft Entra nesnelerini tanımlayıp atayabileceğiniz, işletmeye özgü özniteliklerdir (anahtar-değer çiftleri). Bu makalede özel güvenlik özniteliği tanımlarının nasıl ekleneceği, düzenleneceği veya devre dışı bırakıldığı açıklanır.

Önkoşullar

Özel güvenlik öznitelikleri tanımlarını eklemek veya devre dışı bırakmak için şunlara sahip olmanız gerekir:

• Öznitelik Tanımı Yönetici istrator
• Microsoft Graph PowerShell kullanırken Microsoft.Graph modülü
• Azure AD PowerShell kullanırken AzureADPreview sürüm 2.0.2.138 veya üzeri

Önemli

Varsayılan olarak, Genel Yönetici istrator ve diğer yönetici rollerinin özel güvenlik özniteliklerini okuma, tanımlama veya atama izinleri yoktur.

Öznitelik kümesi ekleme

İpucu

Bu makaledeki adımlar, başladığınız portala göre biraz değişiklik gösterebilir.

Öznitelik kümesi, ilgili özniteliklerden oluşan bir koleksiyondur. Tüm özel güvenlik öznitelikleri bir öznitelik kümesinin parçası olmalıdır. Öznitelik kümeleri yeniden adlandırılamaz veya silinemez.

1. Microsoft Entra yönetim merkezinde Öznitelik Tanımı Yönetici istrator olarak oturum açın.

2. Koruma>Özel güvenlik özniteliklerine göz atın.

3. Yeni bir öznitelik kümesi eklemek için Öznitelik kümesi ekle'ye tıklayın.

   Öznitelik kümesi ekle devre dışıysa, Öznitelik Tanımı Yönetici istrator rolüne atandığınızdan emin olun. Daha fazla bilgi için bkz . Özel güvenlik öznitelikleriyle ilgili sorunları giderme.

4. Ad, açıklama ve en fazla öznitelik sayısı girin.

   Öznitelik kümesi adı, boşluk veya özel karakter içermeyen 32 karakter olabilir. Bir ad belirttikten sonra adı yeniden adlandıramazsınız. Daha fazla bilgi için bkz . Sınırlar ve kısıtlamalar.

   

5. bitirdiğinizde Ekle'ye tıklayın.

   Yeni öznitelik kümesi, öznitelik kümeleri listesinde görünür.

Özel güvenlik özniteliği tanımı ekleme

1. Microsoft Entra yönetim merkezinde Öznitelik Tanımı Yönetici istrator olarak oturum açın.

2. Koruma>Özel güvenlik özniteliklerine göz atın.

3. Özel güvenlik öznitelikleri sayfasında, var olan bir öznitelik kümesini bulun veya öznitelik kümesi ekle'ye tıklayarak yeni bir öznitelik kümesi ekleyin.

   Tüm özel güvenlik özniteliği tanımları bir öznitelik kümesinin parçası olmalıdır.

4. Seçili öznitelik kümesini açmak için tıklayın.

5. Öznitelik kümesine yeni bir özel güvenlik özniteliği eklemek için Öznitelik ekle'ye tıklayın.

   

6. Öznitelik adı kutusuna özel bir güvenlik özniteliği adı girin.

   Özel güvenlik özniteliği adı, boşluk veya özel karakter içermeyen 32 karakter olabilir. Bir ad belirttikten sonra adı yeniden adlandıramazsınız. Daha fazla bilgi için bkz . Sınırlar ve kısıtlamalar.

7. Açıklama kutusuna isteğe bağlı bir açıklama girin.

   Açıklama 128 karakter uzunluğunda olabilir. Gerekirse, daha sonra açıklamayı değiştirebilirsiniz.

8. Veri türü listesinden özel güvenlik özniteliği için veri türünü seçin.

   Veri türü	Açıklama
   Boolean	True, True, false veya False olabilecek bir Boole değeri.
   Tamsayı	32 bit tamsayı.
   String	X karakter uzunluğunda olabilecek bir dize.

9. Birden çok değerin atanmasına izin ver için Evet veya Hayır'ı seçin.

   Bu özel güvenlik özniteliğine birden çok değer atanmasına izin vermek için Evet'i seçin. Bu özel güvenlik özniteliğine yalnızca tek bir değerin atanmasına izin vermek için Hayır'ı seçin.

10. Yalnızca önceden tanımlanmış değerlerin atanmasına izin ver için Evet veya Hayır'ı seçin.

    Bu özel güvenlik özniteliğine önceden tanımlanmış değerler listesinden değerler atanacak şekilde Evet'i seçin. Bu özel güvenlik özniteliğine kullanıcı tanımlı değerler veya önceden tanımlanmış olabilecek değerler atanmasına izin vermek için Hayır'ı seçin.

11. Yalnızca önceden tanımlanmış değerlerin atanmasına izin ver Evet ise, önceden tanımlanmış değerler eklemek için Değer ekle'ye tıklayın.

    Nesnelere atama için etkin bir değer kullanılabilir. Etkin olmayan bir değer tanımlanır, ancak atama için henüz kullanılamaz.

    

12. İşlemi tamamladıktan sonra Kaydet’e tıklayın.

    Yeni özel güvenlik özniteliği, özel güvenlik öznitelikleri listesinde görünür.

13. Önceden tanımlanmış değerler eklemek istiyorsanız, sonraki bölümdeki adımları izleyin.

Özel güvenlik özniteliği tanımını düzenleme

Yeni bir özel güvenlik özniteliği tanımı ekledikten sonra bazı özellikleri düzenleyebilirsiniz. Bazı özellikler sabittir ve değiştirilemez.

1. Microsoft Entra yönetim merkezinde Öznitelik Tanımı Yönetici istrator olarak oturum açın.

2. Koruma>Özel güvenlik özniteliklerine göz atın.

3. Düzenlemek istediğiniz özel güvenlik özniteliğini içeren öznitelik kümesine tıklayın.

4. Özel güvenlik öznitelikleri listesinde, düzenlemek istediğiniz özel güvenlik özniteliği için üç noktaya tıklayın ve ardından Özniteliği düzenle'yi seçin.

5. Etkinleştirilen özellikleri düzenleyin.

6. Yalnızca önceden tanımlanmış değerlerin atanmasına izin ver Evet ise, önceden tanımlanmış değerler eklemek için Değer ekle'ye tıklayın. Etkin mi? ayarını değiştirmek için önceden tanımlanmış mevcut bir değere tıklayın.

   

Özel güvenlik özniteliği tanımını devre dışı bırakma

Özel bir güvenlik özniteliği tanımı ekledikten sonra, bunu silemezsiniz. Ancak, özel bir güvenlik özniteliği tanımını devre dışı bırakabilirsiniz.

1. Microsoft Entra yönetim merkezinde Öznitelik Tanımı Yönetici istrator olarak oturum açın.

2. Koruma>Özel güvenlik özniteliklerine göz atın.

3. Devre dışı bırakmak istediğiniz özel güvenlik özniteliğini içeren öznitelik kümesine tıklayın.

4. Özel güvenlik öznitelikleri listesinde, devre dışı bırakmak istediğiniz özel güvenlik özniteliğinin yanına bir onay işareti ekleyin.

5. Özniteliği devre dışı bırak'a tıklayın.

6. Görüntülenen Özniteliği devre dışı bırak iletişim kutusunda Evet'e tıklayın.

   Özel güvenlik özniteliği devre dışı bırakılır ve Devre dışı bırakılan öznitelikler listesine taşınır.

PowerShell veya Microsoft Graph API

Microsoft Entra kuruluşunuzda özel güvenlik özniteliği tanımlarını yönetmek için PowerShell veya Microsoft Graph API'sini de kullanabilirsiniz. Aşağıdaki örnekler öznitelik kümelerini ve özel güvenlik özniteliği tanımlarını yönetir.

Tüm öznitelik kümelerini alma

Aşağıdaki örnek tüm öznitelik kümelerini alır.

PowerShell

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 : {}

Microsoft Graph

List attributeSets

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

Azure AD PowerShell

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet

En üst öznitelik kümelerini alma

Aşağıdaki örnek en üst öznitelik kümelerini alır.

PowerShell

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Top 10

Microsoft Graph

List attributeSets

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

Azure AD PowerShell

Hiçbiri

Öznitelik kümelerini sırayla alma

Aşağıdaki örnek, öznitelik kümelerini sırayla alır.

PowerShell

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Sort "Id"

Microsoft Graph

List attributeSets

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

Azure AD PowerShell

Hiçbiri

Öznitelik kümesi alma

Aşağıdaki örnek bir öznitelik kümesi alır.

• Öznitelik kümesi: Engineering

PowerShell

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]}

Microsoft Graph

Get attributeSet

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

Azure AD PowerShell

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet -Id "Engineering"

Öznitelik kümesi ekleme

Aşağıdaki örnek yeni bir öznitelik kümesi ekler.

• Öznitelik kümesi: Engineering

PowerShell

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

Microsoft Graph

attributeSet oluşturma

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

Azure AD PowerShell

New-AzureADMSAttributeSet

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

Öznitelik kümesini güncelleştirme

Aşağıdaki örnek bir öznitelik kümesini güncelleştirir.

• Öznitelik kümesi: Engineering

PowerShell

Update-MgDirectoryAttributeSet

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

Microsoft Graph

attributeSet güncelleştirme

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

Azure AD PowerShell

Set-AzureADMSAttributeSet

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

Tüm özel güvenlik özniteliği tanımlarını alma

Aşağıdaki örnek tüm özel güvenlik özniteliği tanımlarını alır.

PowerShell

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    : {}

Microsoft Graph

customSecurityAttributeDefinitions listeleme

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

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition

Özel güvenlik özniteliği tanımlarını filtreleme

Aşağıdaki örnekler özel güvenlik özniteliği tanımlarını filtrelemektedir.

• Filtre: Öznitelik adı eq 'Project' ve durum eq 'Kullanılabilir'

PowerShell

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    : {}

Microsoft Graph

customSecurityAttributeDefinitions listeleme

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

Azure AD PowerShell

Hiçbiri

• Filtre: Öznitelik kümesi eq 'Engineering' ve status eq 'Available' ve veri türü eq 'String'

PowerShell

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    : {}

Microsoft Graph

customSecurityAttributeDefinitions listeleme

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

Azure AD PowerShell

Hiçbiri

Özel güvenlik özniteliği tanımı alma

Aşağıdaki örnek özel bir güvenlik özniteliği tanımı alır.

• Öznitelik kümesi: Engineering
• Öznitelik: ProjectDate

PowerShell

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]}

Microsoft Graph

customSecurityAttributeDefinition alma

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

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition -Id "Engineering_ProjectDate"

Özel güvenlik özniteliği tanımı ekleme

Aşağıdaki örnek yeni bir özel güvenlik özniteliği tanımı ekler.

• Öznitelik kümesi: Engineering
• Öznitelik: ProjectDate
• Öznitelik veri türü: Dize

PowerShell

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]}

Microsoft Graph

customSecurityAttributeDefinition oluşturma

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
}

Azure AD PowerShell

New-AzureADMSCustomSecurityAttributeDefinition

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

Önceden tanımlanmış birden çok değeri destekleyen özel bir güvenlik özniteliği tanımı ekleme

Aşağıdaki örnek, önceden tanımlanmış birden çok değeri destekleyen yeni bir özel güvenlik özniteliği tanımı ekler.

• Öznitelik kümesi: Engineering
• Öznitelik: Project
• Öznitelik veri türü: Dize koleksiyonu

PowerShell

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]}

Microsoft Graph

customSecurityAttributeDefinition oluşturma

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
}

Azure AD PowerShell

Hiçbiri

Önceden tanımlanmış değerlerin listesiyle özel bir güvenlik özniteliği tanımı ekleme

Aşağıdaki örnek, önceden tanımlanmış değerlerin listesiyle yeni bir özel güvenlik özniteliği tanımı ekler.

• Öznitelik kümesi: Engineering
• Öznitelik: Project
• Öznitelik veri türü: Dize koleksiyonu
• Önceden tanımlanmış değerler: Alpine, Baker, Cascade

PowerShell

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]}

Microsoft Graph

customSecurityAttributeDefinition oluşturma

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
        }
    ]
}

Azure AD PowerShell

Hiçbiri

Özel güvenlik özniteliği tanımını güncelleştirme

Aşağıdaki örnek, özel bir güvenlik özniteliği tanımını güncelleştirir.

• Öznitelik kümesi: Engineering
• Öznitelik: ProjectDate

PowerShell

Update-MgDirectoryCustomSecurityAttributeDefinition

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

Microsoft Graph

customSecurityAttributeDefinition güncelleştirme

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

Azure AD PowerShell

Set-AzureADMSCustomSecurityAttributeDefinition

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

Özel bir güvenlik özniteliği tanımı için önceden tanımlanmış değerleri güncelleştirme

Aşağıdaki örnek, özel bir güvenlik özniteliği tanımı için önceden tanımlanmış değerleri güncelleştirir.

• Öznitelik kümesi: Engineering
• Öznitelik: Project
• Öznitelik veri türü: Dize koleksiyonu
• Önceden tanımlanmış değeri güncelleştir: Baker
• Yeni önceden tanımlanmış değer: Skagit

PowerShell

Invoke-MgGraphRequest

Not

Bu istek için OData-Version üst bilgisini eklemeniz ve değerini 4.01atamanız gerekir.

$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

Microsoft Graph

customSecurityAttributeDefinition güncelleştirme

Not

Bu istek için OData-Version üst bilgisini eklemeniz ve değerini 4.01atamanız gerekir.

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

Azure AD PowerShell

Hiçbiri

Özel güvenlik özniteliği tanımını devre dışı bırakma

Aşağıdaki örnek özel bir güvenlik özniteliği tanımını devre dışı bırakır.

• Öznitelik kümesi: Engineering
• Öznitelik: Project

PowerShell

Update-MgDirectoryCustomSecurityAttributeDefinition

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

Microsoft Graph

customSecurityAttributeDefinition güncelleştirme

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

Azure AD PowerShell

Set-AzureADMSCustomSecurityAttributeDefinition

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

Önceden tanımlanmış tüm değerleri alma

Aşağıdaki örnek, özel bir güvenlik özniteliği tanımı için önceden tanımlanmış tüm değerleri alır.

• Öznitelik kümesi: Engineering
• Öznitelik: Project

PowerShell

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 : {}

Microsoft Graph

allowedValues listesini ekleme

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

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project"

Önceden tanımlanmış bir değer alma

Aşağıdaki örnek, özel bir güvenlik özniteliği tanımı için önceden tanımlanmış bir değer alır.

• Öznitelik kümesi: Engineering
• Öznitelik: Project
• Önceden tanımlanmış değer: Alpine

PowerShell

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]}

Microsoft Graph

Get allowedValue

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

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

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

Önceden tanımlanmış bir değer ekleme

Aşağıdaki örnek, özel bir güvenlik özniteliği tanımı için önceden tanımlanmış bir değer ekler.

olarak ayarlanmış trueözel güvenlik öznitelikleri usePreDefinedValuesOnly için önceden tanımlanmış değerler ekleyebilirsiniz.

• Öznitelik kümesi: Engineering
• Öznitelik: Project
• Önceden tanımlanmış değer: Alpine

PowerShell

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]}

Microsoft Graph

allowedValue oluşturma

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

Azure AD PowerShell

Add-AzureADMScustomSecurityAttributeDefinitionAllowedValues

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

Önceden tanımlanmış bir değeri devre dışı bırakma

Aşağıdaki örnek, özel bir güvenlik özniteliği tanımı için önceden tanımlanmış bir değeri devre dışı bırakır.

• Öznitelik kümesi: Engineering
• Öznitelik: Project
• Önceden tanımlanmış değer: Alpine

PowerShell

Update-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

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

Microsoft Graph

allowedValue güncelleştirme

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

Azure AD PowerShell

Set-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

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

Sık sorulan sorular

Özel güvenlik özniteliği tanımlarını silebilir misiniz?

Hayır, özel güvenlik özniteliği tanımlarını silemezsiniz. Yalnızca özel güvenlik özniteliği tanımlarını devre dışı bırakabilirsiniz. Özel bir güvenlik özniteliğini devre dışı bıraktığınızda, artık Microsoft Entra nesnelerine uygulanamıyor. Devre dışı bırakılan özel güvenlik öznitelik tanımı için özel güvenlik özniteliği atamaları otomatik olarak kaldırılmaz. Devre dışı bırakılan özel güvenlik özniteliklerinin sayısıyla ilgili bir sınır yoktur. Kiracı başına özel güvenlik özniteliği tanımı başına izin verilen 100 önceden tanımlanmış değerle 500 etkin özel güvenlik özniteliği tanımına sahip olabilirsiniz.

Sonraki adımlar

• Microsoft Entra Id'de özel güvenlik özniteliklerine erişimi yönetme
• Kullanıcıya özel güvenlik öznitelikleri atama, güncelleştirme, listeleme veya kaldırma
• Bir uygulama için özel güvenlik özniteliklerini atama, güncelleştirme, listeleme veya kaldırma