Get-MsolServicePrincipal

  • Riferimento
Modulo:
MSOnline

Ottiene le entità servizio da Azure Active Directory.

Sintassi

Get-MsolServicePrincipal
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-MsolServicePrincipal ottiene un'entità servizio o un elenco di entità servizio da Azure Active Directory.

Esempio

Esempio 1: Visualizzare tutte le entità servizio

PS C:\> Get-MsolServicePrincipal

Questo comando visualizza tutte le entità servizio esistenti nel tenant dell'organizzazione.

Esempio 2: Ottenere entità servizio usando un nome

PS C:\> Get-MsolServicePrincipal -ServicePrincipalName "MyApp"

Questo comando ottiene tutte le entità servizio esistenti con un nome dell'entità servizio che inizia con MyApp. Questa è una corrispondenza esatta della parte appClass del nome dell'entità servizio fino alla barra in avanti.

Esempio 3: Ottenere un'entità servizio

PS C:\> Get-MsolServicePrincipal -AppPrincipalId 5e964d2f-e384-4292-ae55-dd24c89cc53b

Questo comando ottiene un'entità servizio con un ID entità applicazione specifico.

Parametri

-All

Indica che questo cmdlet restituisce tutti i risultati. Non specificare insieme al parametro MaxResults .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AppPrincipalId

Specifica l'ID applicazione univoco dell'entità servizio da ottenere.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-MaxResults

Specifica il numero massimo di risultati restituiti dal cmdlet. Il valore predefinito è 500.

Tipo:Int32
Posizione:Named
Valore predefinito:500
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ObjectId

Specifica l'ID oggetto univoco dell'entità servizio da ottenere.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SearchString

Specifica una stringa che corrisponde ai nomi dell'entità servizio.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServicePrincipalName

Specifica il nome dell'entità servizio o delle entità servizio da ottenere. Un SPN deve usare uno dei formati seguenti:

  • appName
  • appName/hostname
  • URL valido

AppName rappresenta il nome dell'applicazione e il nome host rappresenta l'autorità URI per l'applicazione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TenantId

Specifica l'ID univoco del tenant in cui eseguire l'operazione. Il valore predefinito è il tenant dell'utente corrente. Questo parametro si applica solo agli utenti partner.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Output

Microsoft.Online.Administration.ServicePrincipal[]

Questo cmdlet restituisce un'entità servizio o un elenco di entità servizio da Azure Active Directory. Ogni entità servizio contiene le seguenti informazioni:

  • Objectid. Identificatore univoco dell'entità servizio.
  • AppPrincipalId. Identificatore dell'applicazione dell'entità servizio.
  • Displayname. Nome descrittivo dell'entità servizio.
  • Serviceprincipalname. Elenco dei nomi dell'entità servizio (SPN) associati all'entità servizio.
  • AccountEnabled. Valore che indica se l'account è abilitato.