Get-User
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Utilizzare il cmdlet Get-User per visualizzare gli oggetti utente esistenti nell'organizzazione. Il cmdlet restituisce tutti gli oggetti che dispongono di account utente (ad esempio, le cassette postali utente, gli utenti di posta elettronica e gli account utente).
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-User
[-Anr <String>]
[-Arbitration]
[-AuditLog]
[-AuxAuditLog]
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-Filter <String>]
[-IgnoreDefaultScope]
[-IsVIP]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-PublicFolder]
[-ReadFromDomainController]
[-RecipientTypeDetails <RecipientTypeDetails[]>]
[-ResultSize <Unlimited>]
[-Sortby <String>]
[-SupervisoryReviewPolicy]
[<CommonParameters>]Get-User
[[-Identity] <UserIdParameter>]
[-Arbitration]
[-AuditLog]
[-AuxAuditLog]
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-Filter <String>]
[-IgnoreDefaultScope]
[-IsVIP]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-PublicFolder]
[-ReadFromDomainController]
[-RecipientTypeDetails <RecipientTypeDetails[]>]
[-ResultSize <Unlimited>]
[-Sortby <String>]
[-SupervisoryReviewPolicy]
[<CommonParameters>]Descrizione
Il cmdlet Get-User non restituisce alcuna proprietà relativa alla posta elettronica per le cassette postali o per gli utenti di posta elettronica. Per visualizzare le proprietà relative alla posta elettronica di un utente, è necessario utilizzare il cmdlet corrispondente in base al tipo di oggetto (ad esempio, Get-Mailbox o Get-MailUser).
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano 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-User -ResultSize unlimitedIn questo esempio viene restituito un elenco riepilogativo di tutti gli utenti presenti nell'organizzazione.
Esempio 2
Get-User -Identity "Coy Damon" | Format-ListIn questo esempio vengono restituite informazioni dettagliate per l'utente denominato Coy Damon.
Esempio 3
Get-User -OrganizationalUnit "Marketing"Con questo esempio vengono recuperate le informazioni sugli utenti dell'unità organizzativa Marketing.
Esempio 4
Get-User -Filter "Title -like 'Manager*'"Con questo esempio viene utilizzato il parametro Filter per recuperare le informazioni su tutti gli utenti il cui titolo contiene alla fine la parola Manager.
Parametri
-Anr
Il parametro Anr consente di specificare una stringa in cui eseguire la ricerca per la risoluzione dei nomi ambigui (ANR). È possibile specificare una stringa parziale e cercare gli oggetti con un attributo che corrisponda alla stringa. Gli attributi predefiniti ricercati sono i seguenti:
- CommonName (CN)
- DisplayName
- FirstName
- LastName
- Alias
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Arbitration
Questo parametro è disponibile solo in Exchange locale.
Il cambio di arbitrato è necessario per restituire le cassette postali di arbitrato nei risultati. Con questa opzione non è necessario specificare alcun valore.
Le cassette postali di arbitrato sono cassette postali di sistema usate per archiviare diversi tipi di dati di sistema e per gestire il flusso di lavoro di approvazione della messaggistica.
Per restituire le cassette postali di arbitrato usate per archiviare le impostazioni o i dati del log di controllo, non usare questa opzione. Usare invece le opzioni AuditLog o AuxAuditLog.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AuditLog
Questo parametro è disponibile solo in Exchange locale.
L'opzione AuditLog è necessaria per restituire le cassette postali del log di controllo nei risultati. Con questa opzione non è necessario specificare alcun valore.
Le cassette postali del log di controllo sono cassette postali di arbitrato usate per archiviare le impostazioni del log di controllo.
Per restituire altri tipi di cassette postali di arbitrato, non usare questa opzione. Usare invece l'opzione Arbitrato.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-AuxAuditLog
Questo parametro è disponibile solo in Exchange locale.
L'opzione AuxAuditLog è necessaria per restituire cassette postali del log di controllo ausiliarie nei risultati. Con questa opzione non è necessario specificare alcun valore.
Le cassette postali del log di controllo sono cassette postali di arbitrato usate per archiviare le impostazioni del log di controllo.
Per restituire altri tipi di cassette postali di arbitrato, non usare questa opzione. Usare invece l'opzione Arbitrato.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Credential
Questo parametro è disponibile solo in Exchange locale.
Il parametro Credential consente di specificare il nome utente e la password usati per eseguire questo comando. In genere questo parametro viene utilizzato negli script o quando occorre fornire credenziali diverse con le autorizzazioni necessarie.
Un valore per questo parametro richiede il cmdlet Get-Credential. Per sospendere questo comando e visualizzare la richiesta di immissione delle credenziali, usare il valore (Get-Credential). In alternativa, prima di eseguire questo comando, archiviare le credenziali in una variabile (ad esempio, $cred = Get-Credential) e quindi usare il nome della variabile ($cred) per questo parametro. Per altre informazioni, vedere Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Questo parametro è disponibile solo in Exchange locale.
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Filter
Il parametro Filter usa la sintassi OPATH per filtrare i risultati in base alle proprietà e ai valori specificati. I criteri di ricerca usano la sintassi "Property -ComparisonOperator 'Value'".
- Racchiudere l'intero filtro OPATH tra virgolette doppie " ". Se il filtro contiene valori di sistema (ad esempio,
$true,$falseo$null), usare le virgolette singole ''. Sebbene questo parametro sia una stringa (non un blocco di sistema), è anche possibile usare le parentesi graffe { }, ma solo se il filtro non contiene variabili. - La proprietà è una proprietà filtrabile. Per altre informazioni sulle proprietà filtrabili in Exchange Server e Exchange Online, vedere Proprietà filtrabili per il parametro Filter.
- ComparisonOperator è un operatore di confronto OPATH, ad esempio
-eqper equals e-likeper il confronto di stringhe. Per ulteriori informazioni sugli operatori di confronto, vedere about_Comparison_Operators. - Il valore è il valore della proprietà da cercare. Racchiudere valori di testo e variabili tra virgolette singole (
'Value'o'$Variable'). Se un valore variabile contiene virgolette singole, è necessario identificare (escape) le virgolette singole per espandere correttamente la variabile. Ad esempio, invece di'$User', usare'$($User -Replace "'","''")'. Non racchiudere valori interi o di sistema tra virgolette, ad esempio usare500,$true,$falseo$null.
È possibile concatenare più criteri di ricerca usando gli operatori -and logici e -or. Ad esempio, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".
Per informazioni dettagliate sui filtri OPATH in Exchange, vedere Informazioni aggiuntive sulla sintassi OPATH.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-Identity
Il parametro Identity consente di rilevare l'utente da visualizzare. È possibile utilizzare qualsiasi valore che identifichi l'utente in modo univoco. Ad esempio:
- Nome
- Nome dell'entità utente (UPN)
- Nome distinto (DN)
- Nome distinto (DN)
- GUID
| Type: | UserIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-IgnoreDefaultScope
Questo parametro è disponibile solo in Exchange locale.
L'opzione IgnoreDefaultScope indica al comando di ignorare l'impostazione dell'ambito del destinatario predefinito per la sessione di Exchange PowerShell e di usare l'intera foresta come ambito. Con questa opzione non è necessario specificare alcun valore.
Questa opzione consente al comando di accedere agli oggetti active directory attualmente non disponibili nell'ambito predefinito, ma introduce anche le restrizioni seguenti:
- Non è possibile utilizzare il parametro DomainController. Il comando utilizza automaticamente un server di catalogo globale appropriato.
- È possibile utilizzare solo il DN per il parametro Identity. Non vengono accettate altre forme di identificazione, ad esempio alias o GUID.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IsVIP
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione IsVIP filtra i risultati in base agli account con priorità. Con questa opzione non è necessario specificare alcun valore.
Per altre informazioni sugli account con priorità, vedere Gestire e monitorare gli account con priorità.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-OrganizationalUnit
Il parametro OrganizationalUnit filtra i risultati in base alla posizione dell'oggetto in Active Directory. Vengono restituiti solo gli oggetti presenti nella posizione specificata. L'input valido per questo parametro è un'unità organizzativa o un dominio restituito dal cmdlet Get-OrganizationalUnit. È possibile utilizzare qualsiasi valore che identifichi l'unità organizzativa o il dominio in modo univoco. Ad esempio:
- Nome
- Nome
- Nome distinto (DN)
- GUID
| Type: | OrganizationalUnitIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PublicFolder
L'opzione PublicFolder è necessaria per restituire le cassette postali delle cartelle pubbliche nei risultati. Con questa opzione non è necessario specificare alcun valore.
Le cassette postali delle cartelle pubbliche sono progettate per memorizzare la gerarchia e il contenuto delle cartelle pubbliche.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance |
-ReadFromDomainController
Questo parametro è disponibile solo in Exchange locale.
L'opzione ReadFromDomainController consente di specificare che le informazioni devono essere lette da un controller di dominio nel dominio dell'utente. Con questa opzione non è necessario specificare alcun valore.
Il comando: Set-AdServerSettings -ViewEntireForest $true per includere tutti gli oggetti nella foresta richiede l'opzione ReadFromDomainController. In caso contrario, il comando potrebbe usare un catalogo globale che contiene informazioni obsolete. Inoltre, potrebbe essere necessario eseguire più iterazioni del comando con l'opzione ReadFromDomainController per ottenere le informazioni.
Per impostazione predefinita, l'ambito del destinatario è impostato sul dominio che ospita i server di Exchange.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RecipientTypeDetails
Il parametro RecipientTypeDetails filtra i risultati in base al sottotipo utente specificato. I valori validi sono:
- DisabledUser
- DiscoveryMailbox
- EquipmentMailbox
- GuestMailUser (Exchange 2016 o versione successiva e cloud)
- GroupMailbox (solo Exchange 2013)
- LegacyMailbox
- LinkedMailbox
- LinkedRoomMailbox (Exchange 2013 o versione successiva e cloud)
- LinkedUser
- MailUser
- PublicFolderMailbox (Exchange 2013 o versione successiva e cloud)
- RemoteEquipmentMailbox
- RemoteRoomMailbox
- RemoteSharedMailbox
- RemoteTeamMailbox (Exchange 2013 o versione successiva e cloud)
- RemoteUserMailbox
- RoomMailbox
- SchedulingMailbox (Exchange 2016 o versione successiva e cloud)
- SharedMailbox
- ShareWithMailUser (solo cloud)
- TeamMailbox (Exchange 2013 o versione successiva e cloud)
- Utente
- UserMailbox
È possibile specificare più valori separati da virgole.
| Type: | RecipientTypeDetails[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-ResultSize
Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le richieste che soddisfano la query, impostare questo parametro sul valore unlimited. Il valore predefinito è 1000.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-Sortby
Il parametro SortBy consente di specificare la proprietà in base a cui ordinare i risultati. È possibile ordinare in base a una sola proprietà alla volta. I risultati vengono visualizzati in ordine crescente.
Se la visualizzazione predefinita non include la proprietà per cui si esegue l'ordinamento, è possibile accodare il comando con | Format-Table -Auto Property1,Property2,...PropertyX. per creare una nuova visualizzazione che contiene tutte le proprietà che si desidera visualizzare. I caratteri jolly (*) nei nomi di proprietà sono supportati.
È possibile eseguire l'ordinamento in base alle seguenti proprietà:
- Nome
- DisplayName
- Città
- FirstName
- LastName
- Office
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance, Exchange Online Protection |
-SupervisoryReviewPolicy
Questo parametro è disponibile solo in Exchange locale.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.
Commenti e suggerimenti
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere: https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per