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.
-
-ApplicationIdparametr określa unikatowy identyfikator aplikacji. -
-Nameparametr 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.
-
-ApplicationIdparametr określa unikatowy identyfikator aplikacji. -
-Nameparametr określa nazwę właściwości rozszerzenia. -
-DataTypeParametr 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.
-
-ApplicationIdparametr określa unikatowy identyfikator aplikacji. -
-Nameparametr 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.