Esplorare il modulo di PowerShell Microsoft Entra

Microsoft Entra PowerShell è uno strumento potente per gestire e amministrare le risorse Entra direttamente da PowerShell.

Questo articolo consente di esplorare il modulo e descrive i concetti di base.

Prerequisiti

Accedere

Ogni cmdlet in Microsoft Entra PowerShell è protetto da uno o più ambiti di autorizzazione. Per usare Microsoft Entra PowerShell, gli utenti che accedono devono fornire il consenso agli ambiti di autorizzazione necessari per il cmdlet che intende usare. Specificare le autorizzazioni nel Connect-Entra cmdlet . Se richiesto, accedere con un account amministratore per il tenant.

Connect-Entra -Scopes 'User.Read.All'

Microsoft Entra PowerShell supporta due tipi di autenticazione: accesso delegato e accesso solo app. Per visualizzare tutte le opzioni possibili, vedere gli scenari di autenticazione.

Trovare i comandi disponibili

I cmdlet di PowerShell di Microsoft Entra seguono una convenzione di denominazione standard di PowerShell, Verb-Noun. Il verbo descrive l'azione (esempi includono , NewGet, , Set) e il sostantivo descrive il tipo di risorsa (esempi includono RemoveUser, Group, ServicePrincipal, Device). I sostantivi in Microsoft Entra PowerShell iniziano sempre con il prefisso Entra. Per l'elenco completo dei verbi standard, vedere i verbi approvati per i comandi di PowerShell.

Note

Per i cmdlet Beta, aggiungere un prefisso Beta al nome della risorsa. Ad esempio, usare Get-EntraBetaUser anziché Get-EntraUser per la versione beta.

È possibile ottenere tutti i comandi disponibili in Microsoft Entra modulo di PowerShell usando il comando seguente:

Get-Command -Module Microsoft.Entra*

Per limitare questo problema, ad esempio, per trovare i comandi correlati alle applicazioni, eseguire il comando seguente.

Get-Command -Module Microsoft.Entra* -Noun *application*

Questo comando mostra tutti i cmdlet, le funzioni e gli alias inclusi nel modulo per la risorsa dell'applicazione.

CommandType     Name                                               Version    Source
-----------     ----                                               -------    ------
Function        Add-EntraApplicationOwner                          1.0.1     Microsoft.Entra
Function        Get-EntraApplication                               1.0.1     Microsoft.Entra
Function        Get-EntraApplicationExtensionProperty              1.0.1     Microsoft.Entra
Function        Get-EntraApplicationKeyCredential                  1.0.1     Microsoft.Entra
Function        Get-EntraApplicationLogo                           1.0.1     Microsoft.Entra
Function        Get-EntraApplicationOwner                          1.0.1     Microsoft.Entra
Function        Get-EntraApplicationPasswordCredential             1.0.1     Microsoft.Entra

Visualizzare le proprietà e i metodi supportati per un comando

Per visualizzare altre proprietà oltre l'output predefinito, eseguire il comando seguente per visualizzare tutte le proprietà supportate:

Get-EntraUser -UserId 'rsmith@contoso.com' | Get-Member

Questo comando visualizza tutte le proprietà e i metodi utente.

accountEnabled                        NoteProperty          bool accountEnabled=True
ageGroup                              NoteProperty          object ageGroup=null
businessPhones                        NoteProperty          Object[]
city                                  NoteProperty          string city=Bellevue
companyName                           NoteProperty          object companyName=null
consentProvidedForMinor               NoteProperty          object
country                               NoteProperty          string
createdDateTime                       NoteProperty          datetime createdDateTime
creationType                          NoteProperty          object creationType=null
deletedDateTime                       NoteProperty          object deletedDateTime=null
DeletionTimestamp                     NoteProperty          object DeletionTimestamp=null
department                            NoteProperty          string department=Retail
DirSyncEnabled                        NoteProperty          object DirSyncEnabled=null
displayName                           NoteProperty          string displayName=Adele Vance
employeeHireDate                      NoteProperty          object employeeHireDate=null
employeeId                            NoteProperty          object employeeId=null
employeeLeaveDateTime                 NoteProperty          object employeeLeaveDateTime=null
employeeOrgData                       NoteProperty          object employeeOrgData=null
employeeType                          NoteProperty          object employeeType=null

Come ottenere assistenza

Per trovare assistenza con i cmdlet di PowerShell Microsoft Entra, usare il Get-Help comando per informazioni dettagliate su comandi specifici, tra cui la sintassi, i parametri e gli esempi di utilizzo. Ad esempio, per altre informazioni sul Get-EntraUser comando, eseguire il comando seguente.

Get-Help Get-EntraUser -Detailed

Questo comando fornisce una guida dettagliata, inclusi la descrizione del cmdlet, i parametri, gli esempi di utilizzo e i comandi correlati, per aiutarti a capire come utilizzarlo in modo efficace in vari scenari.

Nozioni di base

È possibile usare Microsoft Entra PowerShell tramite le guide pratiche dettagliate: