New-EntraApplicationExtensionProperty

Tworzy właściwość rozszerzenia aplikacji.

Składnia

Default (domyślnie)

New-EntraApplicationExtensionProperty

    -ApplicationId <String>
    [-Name <String>]
    [-DataType <String>]
    [-TargetObjects <System.Collections.Generic.List`1[System.String]>]
    [-IsMultiValued <Boolean>]
    [<CommonParameters>]

Opis

Polecenie New-EntraApplicationExtensionProperty cmdlet tworzy właściwość rozszerzenia aplikacji dla obiektu w Microsoft Entra ID.

Przykłady

Przykład 1. Tworzenie właściwości rozszerzenia

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
New-EntraApplicationExtensionProperty -ApplicationId $application.Id -Name 'NewAttribute'
DeletedDateTime Id                                   AppDisplayName  DataType IsSyncedFromOnPremises Name                                                    TargetObjects
--------------- --                                   --------------  -------- ---------------------- ----                                                    -------------
                11112222-bbbb-3333-cccc-4444dddd5555 My new test app String   False                  extension_11112222-bbbb-3333-cccc-4444dddd5555_NewAttribute {}

To polecenie tworzy właściwość rozszerzenia aplikacji typu ciągu dla określonego obiektu.

  • -ApplicationId parametr określa unikatowy identyfikator aplikacji.
  • -Name parametr określa nazwę właściwości rozszerzenia.

Przykład 2. Tworzenie właściwości rozszerzenia z parametrem typu danych

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
New-EntraApplicationExtensionProperty -ApplicationId $application.Id -Name 'NewAttribute1' -DataType 'Boolean'
DeletedDateTime Id                                   AppDisplayName  DataType IsSyncedFromOnPremises Name                                                    TargetObjects
--------------- --                                   --------------  -------- ---------------------- ----                                                    -------------
                11112222-bbbb-3333-cccc-4444dddd5555 My new test app Boolean  False                  extension_11112222-bbbb-3333-cccc-4444dddd5555_NewAttribute {}

To polecenie tworzy właściwość rozszerzenia aplikacji określonego typu danych dla określonego obiektu.

  • -ApplicationId parametr określa unikatowy identyfikator aplikacji.
  • -Name parametr określa nazwę właściwości rozszerzenia.
  • -DataType Parametr określa typ danych wartości, która może być przechowywana przez właściwość rozszerzenia.

Przykład 3. Tworzenie właściwości rozszerzenia z parametrem targets

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
$targets = New-Object System.Collections.Generic.List[System.String]
$targets.Add('User')
New-EntraApplicationExtensionProperty -ApplicationId $application.Id -Name 'NewAttribute2' -TargetObjects $targets
DeletedDateTime Id                                   AppDisplayName  DataType IsSyncedFromOnPremises Name                                                    TargetObjects
--------------- --                                   --------------  -------- ---------------------- ----                                                    -------------
                11112222-bbbb-3333-cccc-4444dddd5555 My new test app String   False                  extension_11112222-bbbb-3333-cccc-4444dddd5555_NewAttribute {User}

W przykładzie pokazano, jak utworzyć właściwość rozszerzenia aplikacji z określonymi obiektami docelowymi dla określonego obiektu.

  • -ApplicationId parametr określa unikatowy identyfikator aplikacji.
  • -Name parametr określa nazwę właściwości rozszerzenia.
  • -TargetObjectsparametr określa Microsoft Graph zasobów, które używają właściwości rozszerzenia. Wszystkie wartości muszą mieć wartość PascalCase.

Parametry

-ApplicationId

Określa unikatowy identyfikator aplikacji w Microsoft Entra ID.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator Obiektu

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-DataType

Określa typ danych wartości, która może być przechowywana przez właściwość rozszerzenia. Obsługiwane są następujące wartości.

  • Binarne — maksymalnie 256 bajtów
  • logiczny
  • DateTime — musi być określony w formacie ISO 8601. Będzie przechowywany w formacie UTC.
  • Liczba całkowita — wartość 32-bitowa.
  • LargeInteger — wartość 64-bitowa.
  • Ciąg — maksymalnie 256 znaków

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-IsMultiValued

Określa, czy właściwość rozszerzenia obsługuje wiele wartości. Ustaw ten parametr na $true, jeśli właściwość rozszerzenia może przechowywać wiele wartości; w przeciwnym razie ustaw go na $false.

Właściwości parametru

Typ:System.Boolean
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Określa nazwę właściwości rozszerzenia.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-TargetObjects

Określa Microsoft Graph zasobów, które mogą używać właściwości rozszerzenia. Wszystkie wartości muszą mieć wartość PascalCase. Obsługiwane są następujące wartości.

  • User
  • Grupa
  • Jednostka Administracyjna
  • Application
  • Urządzenie
  • Organization

Właściwości parametru

Typ:

System.Collections.Generic.List`1[System.String]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.