New-EntraApplicationExtensionProperty
Crea una proprietà di estensione dell'applicazione.
Sintassi
Default (Impostazione predefinita)
New-EntraApplicationExtensionProperty
-ApplicationId <String>
[-Name <String>]
[-DataType <String>]
[-TargetObjects <System.Collections.Generic.List`1[System.String]>]
[-IsMultiValued <Boolean>]
[<CommonParameters>]
Descrizione
Il New-EntraApplicationExtensionProperty cmdlet crea una proprietà di estensione dell'applicazione per un oggetto in Microsoft Entra ID.
Esempio
Esempio 1: Creare una proprietà di estensione
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 {}
Questo comando crea una proprietà di estensione dell'applicazione del tipo stringa per l'oggetto specificato.
-
-ApplicationIdparametro specifica l'identificatore univoco di un'applicazione. -
-Nameparametro specifica il nome della proprietà di estensione.
Esempio 2: Creare una proprietà di estensione con il parametro del tipo di dati
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 {}
Questo comando crea una proprietà di estensione dell'applicazione del tipo di dati specificato per l'oggetto specificato.
-
-ApplicationIdparametro specifica l'identificatore univoco di un'applicazione. -
-Nameparametro specifica il nome della proprietà di estensione. -
-DataTypeparametro specifica il tipo di dati del valore che la proprietà di estensione può contenere.
Esempio 3: Creare una proprietà di estensione con il parametro 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}
Nell'esempio viene illustrato come creare una proprietà di estensione dell'applicazione con gli oggetti di destinazione specificati per l'oggetto specificato.
-
-ApplicationIdparametro specifica l'identificatore univoco di un'applicazione. -
-Nameparametro specifica il nome della proprietà di estensione. -
-TargetObjectsparametro specifica le risorse Microsoft Graph che usano la proprietà di estensione. Tutti i valori devono essere in PascalCase.
Parametri
-ApplicationId
Specifica un ID univoco di un'applicazione in Microsoft Entra ID.
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | ObjectId |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-DataType
Specifica il tipo di dati del valore che la proprietà di estensione può contenere. Sono supportati i valori seguenti.
- Binario - Massimo 256 byte
- Booleano
- DateTime: deve essere specificato in formato ISO 8601. Verrà archiviato in formato UTC.
- Intero - Valore a 32 bit.
- LargeInteger - Valore a 64 bit.
- Stringa - Massimo 256 caratteri
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 |
-IsMultiValued
Specifica se la proprietà di estensione supporta più valori. Impostare questo parametro su $true se la proprietà di estensione può contenere più valori; in caso contrario, impostarlo su $false.
Proprietà dei parametri
| Tipo: | System.Boolean |
| Valore predefinito: | False |
| 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 |
-Name
Specifica il nome della proprietà di estensione.
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 |
-TargetObjects
Specifica le risorse Microsoft Graph che possono usare la proprietà di estensione. Tutti i valori devono essere in PascalCase. Sono supportati i valori seguenti.
- Utente
- Gruppo
- Unità amministrativa
- Application
- Dispositivo
- Organization
Proprietà dei parametri
| Tipo: | System.Collections.Generic.List`1[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 |
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.