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

Makale
11/15/2023

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.

Microsoft Entra yönetim merkezinde Öznitelik Tanımı Yönetici istrator olarak oturum açın.
Koruma>Özel güvenlik özniteliklerine göz atın.
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.
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.
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

Microsoft Entra yönetim merkezinde Öznitelik Tanımı Yönetici istrator olarak oturum açın.
Koruma>Özel güvenlik özniteliklerine göz atın.
Ö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.
Seçili öznitelik kümesini açmak için tıklayın.
Öznitelik kümesine yeni bir özel güvenlik özniteliği eklemek için Öznitelik ekle'ye tıklayın.
Ö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.
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.
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.
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.
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.
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.
İşlemi tamamladıktan sonra Kaydet’e tıklayın.

Yeni özel güvenlik özniteliği, özel güvenlik öznitelikleri listesinde görünür.
Önceden tanımlanmış değerler eklemek istiyorsanız, sonraki bölümdeki adımları izleyin.

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.

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

Microsoft Entra yönetim merkezinde Öznitelik Tanımı Yönetici istrator olarak oturum açın.
Koruma>Özel güvenlik özniteliklerine göz atın.
Düzenlemek istediğiniz özel güvenlik özniteliğini içeren öznitelik kümesine tıklayın.
Ö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.
Etkinleştirilen özellikleri düzenleyin.
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.

Microsoft Entra yönetim merkezinde Öznitelik Tanımı Yönetici istrator olarak oturum açın.
Koruma>Özel güvenlik özniteliklerine göz atın.
Devre dışı bırakmak istediğiniz özel güvenlik özniteliğini içeren öznitelik kümesine tıklayın.
Özel güvenlik öznitelikleri listesinde, devre dışı bırakmak istediğiniz özel güvenlik özniteliğinin yanına bir onay işareti ekleyin.
Özniteliği devre dışı bırak'a tıklayın.
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.

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

List attributeSets

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

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet

En üst öznitelik kümelerini alma

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

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Top 10

List attributeSets

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

Öznitelik kümelerini sırayla alma

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

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Sort "Id"

List attributeSets

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

Öznitelik kümesi alma

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

Öznitelik kümesi: 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]}

Get attributeSet

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

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet -Id "Engineering"

Öznitelik kümesi ekleme

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

Öznitelik kümesi: 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

attributeSet oluşturma

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

Öznitelik kümesini güncelleştirme

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

Öznitelik kümesi: Engineering

Update-MgDirectoryAttributeSet

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

attributeSet güncelleştirme

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

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.

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

customSecurityAttributeDefinitions listeleme

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

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'

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

customSecurityAttributeDefinitions listeleme

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

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

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

customSecurityAttributeDefinitions listeleme

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

Ö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

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

customSecurityAttributeDefinition alma

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

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

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

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
}

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

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

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
}

Ö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

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

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

Ö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

Update-MgDirectoryCustomSecurityAttributeDefinition

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

customSecurityAttributeDefinition güncelleştirme

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)"

Ö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

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

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

Ö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

Update-MgDirectoryCustomSecurityAttributeDefinition

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

customSecurityAttributeDefinition güncelleştirme

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

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

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

allowedValues listesini ekleme

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

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

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

Get allowedValue

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

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

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

allowedValue oluşturma

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

Ö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

Update-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

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

allowedValue güncelleştirme

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

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.

Aracılığıyla paylaş

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

Önkoşullar

Öznitelik kümesi ekleme

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

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

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

PowerShell veya Microsoft Graph API

Tüm öznitelik kümelerini alma

En üst öznitelik kümelerini alma

Öznitelik kümelerini sırayla alma

Öznitelik kümesi alma

Öznitelik kümesi ekleme

Öznitelik kümesini güncelleştirme

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

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

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

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

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

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

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

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

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

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

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

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

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

Sık sorulan sorular

Sonraki adımlar

Geri Bildirim

Ek kaynaklar