Get-MsolUser

  • Riferimento
Modulo:
MSOnline

Ottiene gli utenti da Azure Active Directory.

Sintassi

Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   -ObjectId <Guid>
   [-ReturnDeletedUsers]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   -UserPrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-MsolUser ottiene un singolo utente o un elenco di utenti. Specificare il parametro ObjectId o UserPrincipalName per ottenere un utente specifico.

Esempio

Esempio 1: Ottenere tutti gli utenti

PS C:\> Get-MsolUser

Questo comando recupera tutti gli utenti dell'azienda. Visualizza fino al valore predefinito di 500 risultati.

Esempio 2: Ottenere utenti abilitati

PS C:\> Get-MsolUser -EnabledFilter EnabledOnly -MaxResults 2000

Questo comando ottiene fino a 2000 utenti abilitati.

Esempio 3: Ottenere un utente tramite UPN

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.com"

Questo comando recupera l'utente con l'UPN davidchew@contoso.com.

Esempio 4: Ottenere un utente in base all'ID oggetto

PS C:\> Get-MsolUser -ObjectId 81701046-cb37-439b-90ce-2afd9630af7d

Questo comando recupera un utente con l'ID oggetto specificato.

Esempio 5: Ottenere gli utenti in base alla stringa di ricerca

PS C:\> Get-MsolUser -SearchString "David"

Questo comando recupera un elenco di utenti con David nel nome visualizzato o nell'indirizzo di posta elettronica.

Esempio 6: Ottenere la posizione dati preferita di un utente

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" | Select PreferredDataLocation

Questo comando restituisce la posizione dei dati preferita di un utente.

Parametri

-All

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-City

Specifica la città in cui filtrare i risultati.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Country

Specifica il paese o l'area geografica in cui filtrare i risultati.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Department

Specifica il reparto in cui filtrare i risultati.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainName

Specifica il dominio in cui filtrare i risultati. Questo deve essere un dominio verificato per l'azienda. Tutti gli utenti con un indirizzo di posta elettronica, primario o secondario, in questo dominio vengono restituiti.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnabledFilter

Specifica il filtro per utenti abilitati o disabilitati. I valori validi sono All, EnabledOnly e DisabledOnly.

Type:UserEnabledFilter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HasErrorsOnly

Inida che questo cmdlet restituisce solo gli utenti con errori di convalida.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LicenseReconciliationNeededOnly

Indica che questo filtro cmdlet per solo gli utenti che richiedono la riconciliazione delle licenze.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxResults

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

Type:Int32
Position:Named
Default value:500
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Specifica l'ID oggetto univoco dell'utente da ottenere.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReturnDeletedUsers

Indica che questo cmdlet restituisce solo gli utenti nel cestino del riciclo.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SearchString

Specifica una stringa per corrispondere all'indirizzo di posta elettronica o al nome visualizzato a partire da questa stringa.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-State

Specifica il filtro per lo stato dell'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Synchronized

Indica che questo cmdlet restituisce solo gli utenti sincronizzati tramite Sincronizzazione di Azure Active Directory.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Title

Specifica il filtro per il titolo dell'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UnlicensedUsersOnly

Indica che questo cmdlet restituisce solo gli utenti che non sono assegnati a una licenza.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UsageLocation

Specifica il filtro per il paese o l'area in cui i servizi vengono utilizzati dall'utente. Specificare un paese o un codice area geografica a due lettere.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserPrincipalName

Specifica l'ID utente dell'utente da recuperare.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Output

Microsoft.Online.Administration.User

Questo cmdlet restituisce oggetti utente, che includono le informazioni seguenti:

  • AlternateEmailAddresses. Indirizzo di posta elettronica alternativo dell'utente (esterno ad Azure Active Directory).

  • BlockCredential. indica se l'utente è in grado o meno di effettuare l'accesso.

  • City. la città dell'utente.

  • Paese. Paese o area geografica dell'utente.

  • Dipartimento. il reparto dell'utente.

  • Displayname. Nome visualizzato dell'utente.

  • Errori. una matrice di errori. Si tratta di errori di convalida che possono determinare un'interruzione dei servizi.

  • Fax. il numero di fax dell'utente.

  • Firstname. Nome dell'utente.

  • ImmutableID. restituito solo per gli utenti federati. Questo è l'ID necessario per essere federato con Azure Active Directory.

  • isBlackBerryUser. indica se l'utente dispone o meno di un dispositivo BlackBerry.

  • isLicensed. indica se all'utente sono assegnate licenze.

  • LastDirSyncTime. Data e ora dell'ultima sincronizzazione della directory (restituita solo dagli utenti sincronizzati con Azure Active Directory tramite la sincronizzazione di Active Directory).

  • LastPasswordChangeTimestamp. L'ora più recente in cui è stata registrata una modifica della password per l'utente in Azure Active Directory.

  • LastName Cognome dell'utente.

  • LicenseReconciliationNeeded. indica se l'utente dispone attualmente di una cassetta postale senza licenza. In questo caso all'utente deve essere concessa una licenza valida 30 giorni per evitare di perdere la cassetta postale.

  • Licenze. un elenco delle licenze dell'utente.

  • LiveID. l'ID di accesso univoco dell'utente.

  • Mobilephone. il numero di cellulare dell'utente.

  • Objectid. l'ID univoco dell'utente.

  • Ufficio. il numero dell'ufficio dell'utente.

  • OverallProvisioningStatus. indica se all'utente sono stati forniti i servizi.

  • PasswordNeverExpires. indica se deve essere forzata la modifica della password dell'utente ogni 90 giorni.

  • Phonenumber. il numero di telefono dell'utente.

  • Postalcode. il codice postale dell'utente.

  • PreferredDataLocation. Posizione dati preferita dell'utente.

  • PreferredLanguage. la lingua preferita dell'utente.

  • Proxyaddresses. Indirizzi proxy associati all'utente.

  • Stato. lo stato dell'utente.

  • StreetAddress. l'indirizzo dell'utente.

  • StrongPasswordRequired. indica se l'utente deve impostare una password complessa quando cambia la password. È consigliato l'utilizzo delle password complesse.

  • Titolo. la qualifica dell'utente.

  • UsageLocation. Paese o area geografica in cui i servizi vengono utilizzati dall'utente. Deve trattarsi di un codice paese o area geografica di due lettere.

  • Userprincipalname. L'ID utente.

  • ValidationStatus. indica se sono presenti errori associati all'utente.