New-EntraBetaCustomSecurityAttributeDefinition

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

Skapa ett nytt customSecurityAttributeDefinition-objekt.

Syntax

Default (Standard) 

New-EntraBetaCustomSecurityAttributeDefinition

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

Description

Cmdleten New-EntraBetaCustomSecurityAttributeDefinition skapar ett nytt customSecurityAttributeDefinition-objekt. Ange IsSearchableparametrarna , , AttributeSetIsCollection, Typeoch UsePreDefinedValuesOnlyNameStatus för att skapa en ny definition för anpassade säkerhetsattribut.

Du kan definiera upp till 500 aktiva objekt i en klientorganisation.

Den inloggade användaren måste tilldelas någon av följande katalogroller:

  • Attributdefinitionsadministratör

Exempel

Exempel 1: Lägg till ett anpassat säkerhetsattribut

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

Det här exemplet visar hur du lägger till ett anpassat säkerhetsattribut.

  • -Name parameter anger namnet på det anpassade säkerhetsattributet.
  • -Description parametern anger beskrivningen av det anpassade säkerhetsattributet.
  • -Type parameter anger datatypen för värdena för anpassade säkerhetsattribut.
  • -Status parameter anger att det anpassade säkerhetsattributet är aktivt eller inaktiverat.
  • -AttributeSet parameter anger namnet på attributuppsättningen.
  • -IsCollection parametern anger att tillåter att flera värden kan tilldelas till det anpassade säkerhetsattributet.
  • -IsSearchable parameter anger att värdena för anpassade säkerhetsattribut indexeras för sökning efter objekt.
  • -UsePreDefinedValuesOnly parameter anger att de enda fördefinierade värdena kan tilldelas till det anpassade säkerhetsattributet.

Parametrar

-AttributeSet

Namn på attributuppsättningen. Skiftlägesokänsligt.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Description

Beskrivning av det anpassade säkerhetsattributet, upp till 128 tecken långt och inklusive Unicode-tecken. Den här beskrivningen kan ändras senare.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-IsCollection

Anger om flera värden kan tilldelas till det anpassade säkerhetsattributet. Det går inte att ändra senare. Om typen är inställd på boolesk kan isCollection inte anges till true.

Parameteregenskaper

Typ:System.Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-IsSearchable

Anger om anpassade säkerhetsattributvärden indexeras för sökning efter objekt som har tilldelats attributvärden. Det går inte att ändra senare.

Parameteregenskaper

Typ:System.Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

Namnet på det anpassade säkerhetsattributet. Måste vara unikt i en attributuppsättning. Kan vara upp till 32 tecken långt och innehålla Unicode-tecken. Får inte innehålla blanksteg eller specialtecken. Det går inte att ändra senare. Skiftlägesokänsligt.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Status

Anger om det anpassade säkerhetsattributet är aktivt eller inaktiverat. Acceptabla värden är: Tillgängliga och inaktuella. Kan ändras senare.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Type

Datatyp för de anpassade säkerhetsattributvärdena. Typer som stöds är: Boolesk, Heltal och Sträng. Det går inte att ändra senare.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-UsePreDefinedValuesOnly

Anger om endast fördefinierade värden kan tilldelas till det anpassade säkerhetsattributet. Om värdet är falskt tillåts friformulärvärden. Kan senare ändras från sant till falskt, men kan inte ändras från false till true. Om typen är inställd på boolesk kan du inte användaPreDefinedValuesOnly som sant.

Parameteregenskaper

Typ:System.Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

None

Utdata

System.Object