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.

  • -ApplicationId parametro specifica l'identificatore univoco di un'applicazione.
  • -Name parametro 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.

  • -ApplicationId parametro specifica l'identificatore univoco di un'applicazione.
  • -Name parametro specifica il nome della proprietà di estensione.
  • -DataType parametro 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.

  • -ApplicationId parametro specifica l'identificatore univoco di un'applicazione.
  • -Name parametro 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.