Riferimento rapido di Exchange Management Shell per Exchange 2013
Si applica a: Exchange Server 2013
In questo argomento sono illustrati i cmdlet maggiormente utilizzati per la versione RTM (Release To Manufacturing) e successive di Microsoft Exchange Server 2013 e vengono forniti alcuni esempi di utilizzo.
Nota
Presto verranno aggiunti ulteriori contenuti su altre aree di Exchange 2013.
Per ulteriori informazioni su Exchange Management Shell in Exchange 2013 e su tutti i cmdlet disponibili, vedere gli argomenti seguenti:
Argomenti su cui si desiderano informazioni
Cmdlet per azioni comuni
I verbi seguenti sono supportati dalla maggioranza dei cmdlet e sono associati a un'azione specifica.
| Verbo | Descrizione |
|---|---|
| Nuovo | Il verbo New consente di creare un'istanza di un elemento, ad esempio una nuova impostazione di configurazione, un nuovo database o un nuovo connettore SMTP. |
| Remove | Il verbo Remove consente di rimuovere un'istanza di un elemento, ad esempio una cassetta postale o una regola di trasporto. Tutti i cmdlet Remove supportano i parametri WhatIf e Confirm. Per ulteriori informazioni su questi parametri, vedere Important Parameters. |
| Attivazione | Il verbo Enable consente di abilitare un'impostazione o la ricezione di posta per un destinatario. |
| Disable | Il verbo Disable consente di disabilitare un'impostazione o la ricezione di posta per un destinatario. Tutti i cmdlet Disable supportano i parametri WhatIf e Confirm. Per ulteriori informazioni su questi parametri, vedere Important Parameters. |
| Set | Il verbo Set consente di modificare impostazioni specifiche di un oggetto, ad esempio l'alias di un contatto o il mantenimento di elementi eliminati di un database di cassette postali. |
| Get | Il verbo Get consente di eseguire una query su un oggetto specifico o un sottoinsieme di un tipo di oggetto, ad esempio una cassetta postale specifica, tutti gli utenti di cassette postali o gli utenti di cassette postali in un dominio. |
Parametri importanti
I parametri seguenti consentono di controllare la modalità di esecuzione dei comandi e indicano esattamente quali operazioni verranno eseguite da un comando prima che influenzi i dati.
| Parametro | Descrizione |
|---|---|
| Identità | Il parametro Identity identifica l'oggetto univoco per l'attività. Esso è in genere utilizzato con i cmdlet Enalbe, Disable, Remove, Set e Get. Identity è inoltre un parametro di posizione, ovvero non è necessario specificare Identity quando si specifica il valore del parametro sulla riga di comando. Ad esempio, Get-Mailbox-Identity user1 esegue una query sulla cassetta postale di user1. Get-Mailbox user1 equivale a Get-Mailbox -Identity user1. |
| Whatif | Il parametro WhatIf indica al cmdlet di simulare le azioni da eseguire sull'oggetto. Utilizzando il parametro WhatIf, è possibile visualizzare quali modifiche verrebbero apportate senza effettivamente applicarle. Il valore predefinito è $true. |
| Conferma | Il parametro Confirm determina l'interruzione dell'elaborazione del cmdlet e richiede che l'amministratore sia a conoscenza dell'operazione che verrà eseguita dal cmdlet prima che l'elaborazione continui. Il valore predefinito è $true. |
| Convalida | Il parametro Validate determina la verifica, da parte del cmdlet, che siano soddisfatti tutti i prerequisiti per l'esecuzione dell'operazione e che l'operazione venga completata correttamente. |
Suggerimenti pratici
I comandi seguenti sono associati a varie attività che è possibile utilizzare per l'amministrazione di Exchange 2013.
| Cmdlet | Descrizione |
|---|---|
Get-Command |
Questo cmdlet recupera tutte le attività che possono essere eseguite in Exchange 2013. |
Get-Command *keyword* |
Questo cmdlet recupera le attività con parola chiave nel cmdlet. |
Get-Task | Get-Member |
Questo cmdlet recupera tutte le proprietà e i metodi di Task. |
Get-Task | Format-List |
Questo cmdlet visualizza l'output della query in un elenco formattato. È possibile inviare tramite pipe l'output di qualsiasi cmdlet Get a Format-List per visualizzare l'intero set di proprietà esistenti nell'oggetto restituito da tale comando oppure è possibile specificare singole proprietà da visualizzare, separate da virgole, come nell'esempio seguente: Get-Mailbox john | Format-List alias,*quota*. |
Help Task |
Questo cmdlet recupera le informazioni della Guida di Exchange Management Shell per qualsiasi attività in Exchange 2013, come nell'esempio seguente: Help Get-Mailbox. |
Get-Task | Format-List > file.txt |
Questo cmdlet esporta l'output di Task in un file di testo: file.txt |
Autorizzazioni
| Comando | Descrizione |
|---|---|
Get-RoleGroupMember "Organization Management" |
Questo comando recupera i membri del gruppo di ruoli gestione gestione organizzazione . |
Get-ManagementRoleAssignment -Role "Mail Recipient Creation" -GetEffectiveUsers |
Questo comando recupera l'elenco di tutti gli utenti a cui sono state concesse le autorizzazioni fornite dal ruolo di gestione Mail Recipient Creation. Sono inclusi gli utenti membri dei gruppi di ruoli o dei gruppi di sicurezza universali a cui è stato assegnato il ruolo Mail Recipient Creation. Non sono inclusi gli utenti membri dei gruppi di ruoli collegati in un'altra foresta. |
Get-ManagementRoleAssignment -RoleAssignee Administrator | Get-ManagementRole | Get-ManagementRoleEntry |
Questo comando recupera un elenco di cmdlet che possono essere eseguiti dall'utente Administrator. |
ForEach ($RoleEntry in Get-ManagementRoleEntry *Remove-Mailbox -Parameters Identity) {Get-ManagementRoleAssignment -Role $RoleEntry.Role -GetEffectiveUsers -Delegating $False | Where-Object {$_.EffectiveUserName -Ne "All Group Members"} | FL Role, EffectiveUserName, AssignmentChain} |
Questo comando recupera l'elenco di tutti gli utenti che possono eseguire il cmdlet Remove-Mailbox. |
Get-ManagementRoleAssignment -WritableRecipient kima -GetEffectiveUsers | FT RoleAssigneeName, EffectiveUserName, Role, AssignmentChain |
Questo comando recupera l'elenco di tutti gli utenti che possono modificare la cassetta postale di kima. |
New-ManagementScope "Seattle Users" -RecipientRestrictionFilter "City -Eq 'Seattle'" New-RoleGroup "Seattle Admins" -Roles "Mail Recipients", "Mail Recipient Creation", "Mailbox Import Export", -CustomRecipientWriteScope "Seattle Users" |
Questo comando crea un nuovo ambito di gestione e un nuovo gruppo di ruoli di gestione per consentire ai membri di tale gruppo di gestire i destinatari di Seattle. Viene creato innanzitutto l'ambito di gestione Seattle Users, che include solo i destinatari per cui l'attributo City del relativo oggetto utente è impostato su Seattle. Viene quindi creato un nuovo gruppo di ruoli denominato Seattle Admins e vengono assegnati i ruoli Destinatari di posta elettronica, Creazione destinatari posta e Importazione esportazione cassette postali . L'ambito del gruppo di ruoli viene definito in modo che i relativi membri possano gestire solo gli utenti che rientrano nell'ambito del filtro dei destinatari Seattle Users. |
New-ManagementScope "Vancouver Servers" -ServerRestrictionFilter "ServerSite -Eq 'Vancouver'" $RoleGroup = Get-RoleGroup "Server Management" <br/><br/> New-RoleGroup "Vancouver Server Management" -Roles $RoleGroup.Roles -CustomConfigWriteScope "Vancouver Servers" |
Questo comando crea un nuovo ambito di gestione e copia un gruppo di ruoli esistente per consentire ai membri del nuovo gruppo di gestire solo i server del sito di Active Directory Vancouver. Viene creato innanzitutto l'ambito di gestione Vancouver Servers, che include solo i server disponibili nel sito Active Directory Vancouver. Tale sito Active Directory è memorizzato nell'attributo ServerSite degli oggetti server. Viene quindi creato un nuovo gruppo di ruoli di nome Vancouver Server Management, costituito da una copia del gruppo di ruoli Server Management. Per il nuovo gruppo di ruoli viene tuttavia definito un ambito che consente ai membri di gestire solo i server che rientrano nell'ambito del filtro di configurazione Vancouver Servers. |
Add-RoleGroupMember "Organization Management" -Member davids |
Questo comando aggiunge l'utente davids al gruppo di ruoli Organization Management. |
Get-ManagementRoleAssignment -Role "Mail Recipient Creation" -RoleAssignee "Seattle Admins" | Remove-ManagementRoleAssignment |
Questo comando rimuove il ruolo Mail Recipient Creation dal gruppo di ruoli Seattle Admins. Questo comando è utile perché non è necessario conoscere il nome dell'assegnazione del ruolo di gestione che associa il ruolo al gruppo di ruoli. |
Remote Shell
| Comando | Descrizione |
|---|---|
$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos Import-PSSession $Session |
Questi comandi aprono una nuova sessione shell remota tra un computer aggiunto a un dominio locale e un server Exchange 2013 remoto con il nome di dominio completo ExServer.contoso.com. Utilizzare questo comando se si desidera gestire un server Exchange 2013 remoto e si dispone solo di Windows Management Framework, che include l'interfaccia della riga di comando Windows PowerShell, installata nel computer locale. Questo comando utilizza le credenziali di accesso correnti per l'autenticazione sul server Exchange 2013 remoto. |
$UserCredential = Get-Credential $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos -Credential $UserCredential Import-PSSession $Session |
Questi comandi aprono una nuova sessione shell remota tra un computer aggiunto a un dominio locale e un server Exchange 2013 remoto con il nome di dominio completo ExServer.contoso.com. Utilizzare questo comando se si desidera gestire un server Exchange 2013 remoto e si dispone solo di Windows Management Framework, che include Windows PowerShell, installato nel computer locale. Questo comando utilizza le credenziali specificate esplicitamente per l'autenticazione sul server Exchange 2013 remoto. |
Remove-PSSession $Session |
Questo comando chiude la sessione shell remota tra un computer locale e il server Exchange 2013 remoto. |
Import-RecipientDataProperty -Identity "Tony Smith" -SpokenName -FileData ([System.IO.File]::ReadAllBytes('M:\AudioFiles\TonySmith.wma')) |
Questo comando mostra un esempio della sintassi necessaria per importare un file in un server Exchange 2013 remoto usando il parametro FileData in un cmdlet. La sintassi comprende i dati contenuti nel file M:\AudioFiles\TonySmith.wma e invia tramite flusso i dati alla proprietà FileData sul cmdlet Import-RecipientDataProperty. Il parametro FileData accetta i dati da un file nel computer locale usando questa sintassi nella maggior parte dei cmdlet. |
$SN = Export-RecipientDataProperty -Identity tonys@contoso.com -SpokenName |
Questo comando mostra un esempio della sintassi necessaria per esportare un file da un server Exchange 2013 remoto. La sintassi comprende i dati archiviati nella proprietà FileData sull'oggetto restituito dal cmdlet e quindi invia tramite flusso i dati al computer locale. I dati vengono quindi archiviati nel file C:\tonysmith.wma. La maggior parte dei cmdlet che emette oggetti con una proprietà FileData utilizza questa sintassi per esportare dati in un file sul computer locale. |