New-EntraBetaCustomSecurityAttributeDefinition

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

Creare un nuovo oggetto customSecurityAttributeDefinition.

Sintassi

Default (Impostazione predefinita) 

New-EntraBetaCustomSecurityAttributeDefinition

    -IsSearchable <Boolean>
    -IsCollection <Boolean>
    -AttributeSet <String>
    -Type <String>
    -Name <String>
    -Status <String>
    -UsePreDefinedValuesOnly <Boolean>
    [-Description <String>]
    [<CommonParameters>]

Descrizione

Il New-EntraBetaCustomSecurityAttributeDefinition cmdlet crea un nuovo oggetto customSecurityAttributeDefinition. Specificare IsSearchablei parametri , IsCollectionTypeAttributeSet, , Name, Status e UsePreDefinedValuesOnly per creare una nuova definizione di attributo di sicurezza personalizzata.

È possibile definire fino a 500 oggetti attivi in un tenant.

All'utente connesso deve essere assegnato uno dei ruoli della directory seguenti:

  • Amministratore delle definizioni di attributo

Esempio

Esempio 1: Aggiungere un attributo di sicurezza personalizzato

Connect-Entra -Scopes 'CustomSecAttributeDefinition.Read.All', 'CustomSecAttributeDefinition.ReadWrite.All'
$attributeSet = Get-EntraAttributeSet -Id 'ContosoSet'
$params = @{
    Name                    = 'ProjectTest'
    Description             = 'Target completion'
    Type                    = 'String'
    Status                  = 'Available'
    AttributeSet            = $attributeSet.Id
    IsCollection            = $False
    IsSearchable            = $True
    UsePreDefinedValuesOnly = $True
}
New-EntraBetaCustomSecurityAttributeDefinition @params

Id               AttributeSet Description       IsCollection IsSearchable Name        Status    Type   UsePreDefinedValuesOnly
--               ------------ -----------       ------------ ------------ ----        ------    ----   -----------------------
Test_ProjectTest Test         Target completion False        True         ProjectTest Available String False

In questo esempio viene illustrato come aggiungere un attributo di sicurezza personalizzato.

  • -Name parametro specifica il nome dell'attributo di sicurezza personalizzato.
  • -Description parametro specifica la descrizione dell'attributo di sicurezza personalizzato.
  • -Type parametro specifica il tipo di dati per i valori dell'attributo di sicurezza personalizzato.
  • -Status parametro specifica che l'attributo di sicurezza personalizzato è attivo o disattivato.
  • -AttributeSet parametro specifica il nome del set di attributi.
  • -IsCollection parametro specifica che consente l'assegnazione di più valori all'attributo di sicurezza personalizzato.
  • -IsSearchable parametro specifica che i valori degli attributi di sicurezza personalizzati vengono indicizzati per la ricerca su oggetti.
  • -UsePreDefinedValuesOnly parametro specifica che gli unici valori predefiniti possono essere assegnati all'attributo di sicurezza personalizzato.

Parametri

-AttributeSet

Nome del set di attributi. Senza distinzione tra maiuscole e minuscole.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Description

Descrizione dell'attributo di sicurezza personalizzato, con lunghezza fino a 128 caratteri e inclusi i caratteri Unicode. Questa descrizione può essere modificata in un secondo momento.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IsCollection

Indica se è possibile assegnare più valori all'attributo di sicurezza personalizzato. Non è possibile modificare in un secondo momento. Se il tipo è impostato su Boolean, isCollection non può essere impostato su true.

Proprietà dei parametri

Tipo:System.Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IsSearchable

Indica se i valori degli attributi di sicurezza personalizzati vengono indicizzati per la ricerca in oggetti assegnati a valori di attributo. Non è possibile modificare in un secondo momento.

Proprietà dei parametri

Tipo:System.Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Nome dell'attributo di sicurezza personalizzato. Deve essere univoco all'interno di un set di attributi. Può contenere fino a 32 caratteri e includere caratteri Unicode. Non può contenere spazi o caratteri speciali. Non è possibile modificare in un secondo momento. Senza distinzione tra maiuscole e minuscole.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Status

Specifica se l'attributo di sicurezza personalizzato è attivo o disattivato. I valori accettabili sono: Disponibile e Deprecato. Può essere modificato in un secondo momento.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Type

Tipo di dati per i valori degli attributi di sicurezza personalizzati. I tipi supportati sono: Boolean, Integer e String. Non è possibile modificare in un secondo momento.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UsePreDefinedValuesOnly

Indica se è possibile assegnare solo valori predefiniti all'attributo di sicurezza personalizzato. Se impostato su false, sono consentiti valori in formato libero. Può essere successivamente modificato da true a false, ma non può essere modificato da false a true. Se il tipo è impostato su Boolean, usePreDefinedValuesOnly non può essere impostato su true.

Proprietà dei parametri

Tipo:System.Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Output

System.Object