New-EntraBetaCustomSecurityAttributeDefinition

Maak een nieuw customSecurityAttributeDefinition-object.

Syntax

Default (Standaard)

New-EntraBetaCustomSecurityAttributeDefinition

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

Description

De New-EntraBetaCustomSecurityAttributeDefinition cmdlet maakt een nieuw customSecurityAttributeDefinition-object. Geef IsSearchableparameters op, IsCollection, AttributeSet, Typeen UsePreDefinedValuesOnlyNameStatus parameters voor het maken van een nieuwe definitie van het aangepaste beveiligingskenmerk.

U kunt maximaal 500 actieve objecten in een tenant definiëren.

Aan de aangemelde gebruiker moet een van de volgende directoryrollen zijn toegewezen:

  • Kenmerkdefinitiebeheerder

Voorbeelden

Voorbeeld 1: Een aangepast beveiligingskenmerk toevoegen

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 dit voorbeeld ziet u hoe u een aangepast beveiligingskenmerk toevoegt.

  • -Name parameter geeft de naam van het aangepaste beveiligingskenmerk.
  • -Description parameter geeft de beschrijving van het aangepaste beveiligingskenmerk.
  • -Type parameter geeft het gegevenstype voor de aangepaste beveiligingskenmerkwaarden.
  • -Status parameter geeft aan dat het aangepaste beveiligingskenmerk actief of gedeactiveerd is.
  • -AttributeSet parameter geeft de naam van de kenmerkenet.
  • -IsCollection parameter geeft aan dat meerdere waarden kunnen worden toegewezen aan het aangepaste beveiligingskenmerk.
  • -IsSearchable parameter geeft de aangepaste beveiligingskenmerkwaarden worden geïndexeerd voor het zoeken op objecten.
  • -UsePreDefinedValuesOnly parameter geeft de enige vooraf gedefinieerde waarden kunnen worden toegewezen aan het aangepaste beveiligingskenmerk.

Parameters

-AttributeSet

Naam van de kenmerkenset. Hoofdlettergevoelig.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Description

Beschrijving van het aangepaste beveiligingskenmerk, maximaal 128 tekens lang en inclusief Unicode-tekens. Deze beschrijving kan later worden gewijzigd.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IsCollection

Geeft aan of meerdere waarden kunnen worden toegewezen aan het aangepaste beveiligingskenmerk. Kan later niet meer worden gewijzigd. Als het type is ingesteld op Booleaanse waarde, kan isCollection niet worden ingesteld op waar.

Parametereigenschappen

Type:System.Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IsSearchable

Hiermee wordt aangegeven of aangepaste waarden voor beveiligingskenmerken worden geïndexeerd voor het zoeken naar objecten waaraan kenmerkwaarden zijn toegewezen. Kan later niet meer worden gewijzigd.

Parametereigenschappen

Type:System.Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

Naam van het aangepaste beveiligingskenmerk. Moet uniek zijn binnen een kenmerkenset. Kan maximaal 32 tekens lang zijn en Unicode-tekens bevatten. Mag geen spaties of speciale tekens bevatten. Kan later niet meer worden gewijzigd. Hoofdlettergevoelig.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Status

Geeft aan of het aangepaste beveiligingskenmerk actief of gedeactiveerd is. Acceptabele waarden zijn: Beschikbaar en Afgeschaft. Kan later worden gewijzigd.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Type

Gegevenstype voor de waarden van het aangepaste beveiligingskenmerk. Ondersteunde typen zijn: Booleaanse waarde, geheel getal en tekenreeks. Kan later niet meer worden gewijzigd.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-UsePreDefinedValuesOnly

Geeft aan of alleen vooraf gedefinieerde waarden kunnen worden toegewezen aan het aangepaste beveiligingskenmerk. Als deze optie is ingesteld op onwaar, zijn vrije-formulierwaarden toegestaan. Kan later worden gewijzigd van waar in onwaar, maar kan niet worden gewijzigd van onwaar in waar. Als het type is ingesteld op Booleaanse waarde, kan usePreDefinedValuesOnly niet worden ingesteld op true.

Parametereigenschappen

Type:System.Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

None

Uitvoerwaarden

System.Object