Get-MsolUser
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 .
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-City
Specifica la città in cui filtrare i risultati.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Country
Specifica il paese o l'area geografica in cui filtrare i risultati.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Department
Specifica il reparto in cui filtrare i risultati.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | 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.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | 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.
Tipo: | UserEnabledFilter |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HasErrorsOnly
Inida che questo cmdlet restituisce solo gli utenti con errori di convalida.
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | 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.
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxResults
Specifica il numero massimo di risultati restituiti dal cmdlet. Il valore predefinito è 500.
Tipo: | Int32 |
Position: | Named |
valore predefinito: | 500 |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
Specifica l'ID oggetto univoco dell'utente da ottenere.
Tipo: | Guid |
Position: | Named |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ReturnDeletedUsers
Indica che questo cmdlet restituisce solo gli utenti nel cestino del riciclo.
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | 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.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
Specifica il filtro per lo stato dell'utente.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | 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.
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | 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.
Tipo: | Guid |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Title
Specifica il filtro per il titolo dell'utente.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | 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.
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | 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.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPrincipalName
Specifica l'ID utente dell'utente da recuperare.
Tipo: | String |
Position: | Named |
valore predefinito: | None |
Necessario: | 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.
Collegamenti correlati
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per