Get-ServicePrincipal

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Get-ServicePrincipal per visualizzare informazioni sulle entità servizio nell'organizzazione basata su cloud.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Default (Impostazione predefinita) 

Get-ServicePrincipal
    [[-Identity] <ServicePrincipalIdParameter>]
    [-Organization <OrganizationIdParameter>]
    [<CommonParameters>]

Descrizione

Le entità servizio sono presenti in Microsoft Entra ID per definire cosa possono fare le app, chi può accedere alle app e a quali risorse possono accedere le app. In Exchange Online, le entità servizio sono riferimenti alle entità servizio in Microsoft Entra ID. Per assegnare ruoli di controllo degli accessi in base ai ruoli di Exchange Online alle entità servizio in Microsoft Entra ID, si usano i riferimenti alle entità servizio in Exchange Online. I cmdlet *-ServicePrincipal in PowerShell per Exchange Online consentono di visualizzare, creare e rimuovere questi riferimenti all'entità servizio.

Per altre informazioni, vedere Oggetti entità applicazione e servizio in Microsoft Entra ID.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Get-ServicePrincipal

In questo esempio viene restituito un elenco di riepilogo di tutte le entità servizio all'interno di un'organizzazione.

Esempio 2

Get-ServicePrincipal -Identity ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1 | Format-List

Questo esempio restituisce informazioni dettagliate sull'entità servizio con il valore ObjectId ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1.

Parametri

-Identity

Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali

Il parametro Identity consente di specificare l'entità servizio che si desidera visualizzare. È possibile usare qualsiasi valore che identifichi in modo univoco l'entità servizio. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID
  • AppId
  • ObjectId

Attenzione: il valore $null o un valore inesistente per il parametro Identity restituisce tutti gli oggetti come se si eseguisse il comando Get- senza il parametro Identity. Verificare che tutti gli elenchi di valori per il parametro Identity siano accurati e non contengano valori $null inesistenti.

Proprietà dei parametri

Tipo:ServicePrincipalIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Organization

Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Tipo:OrganizationIdParameter
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, vedere about_CommonParameters.