Visualizzazione della Guida

Articolo
08/10/2014

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Ultima modifica dell'argomento: 2006-11-15

In Microsoft Exchange Server 2007 vengono fornite molte risorse della Guida per consentire all'utente di sfruttare tutte le potenzialità di Exchange Management Shell. In questo argomento vengono descritte le seguenti risorse della Guida e funzionalità:

File della Guida di Exchange 2007 Il file della Guida di Exchange 2007 contiene tutti gli argomenti della Guida relativi ai cmdlet ordinati secondo una gerarchia basata su ruoli e attività. Gli argomenti della Guida relativi ai cmdlet sono inoltre collegati ad argomenti relativi alle procedure che indicano come eseguire specifiche attività.
Cmdlet della Guida Exchange Management Shell dispone di vari cmdlet che consentono di trovare le informazioni appropriate per completare l'attività.
Visualizzazioni della Guida La Guida di Exchange Management Shell contiene diverse informazioni sui cmdlet disponibili. Le visualizzazioni della Guida consentono di accedere alle informazioni necessarie relative a un cmdlet.
Ruoli, componenti e funzionalità dei cmdlet È possibile elencare i cmdlet secondo il ruolo, il componente o la funzionalità che gestiscono. Ciò consente di trovare il cmdlet appropriato per il ruolo, il componente o la funzionalità che si desidera gestire.
Completamento con TAB È possibile utilizzare il completamento con TAB sui nomi dei cmdlet e dei parametri per ridurre la quantità di testo da immettere sulla riga di comando.

File della Guida di Exchange 2007

Il file della Guida di Exchange 2007 contiene le stesse informazioni della Guida relative ai cmdlet disponibili in tutti i cmdlet in Exchange Management Shell. Tuttavia, nel file della Guida di Exchange 2007, la Guida di tutti i cmdlet è organizzata per ruolo del server e attività amministrativa, per consentire di trovare facilmente cmdlet specifici associati all'attività che si desidera eseguire. Inoltre, gli argomenti relativi ai cmdlet nel file della Guida di Exchange 2007 sono collegati agli argomenti che presentano le funzionalità da essi gestite, mostrano come utilizzare i cmdlet per gestire tali funzionalità e forniscono dettagli specifici sulla funzionalità o scenari comuni.

Per ulteriori informazioni sugli argomenti della Guida relativi ai cmdlet disponibili nel file della Guida di Exchange 2007, vedere Exchange Management Shell (SP1 e SP2).

Per ulteriori informazioni su come utilizzare i cmdlet di Exchange Management Shell per eseguire attività specifiche, vedere Operazioni.

Cmdlet della Guida

Nelle seguenti tabelle vengono forniti esempi su come utilizzare i cmdlet Get-Help, Get-Command e Get-ExCommand per accedere alle informazioni della Guida disponibili per ciascun cmdlet in Exchange Management Shell.

Nella tabella 1 viene fornito un esempio di come viene utilizzato il cmdlet Get-Help.

Tabella 1 Esempi di utilizzo del comando Get-Help

Comando	Descrizione
`Get-Help`	Quando il cmdlet Get-Help viene utilizzato da solo fornisce istruzioni di base sull'utilizzo del sistema della Guida di Exchange Management Shell.
`Get-Help <cmdlet>`	Quando al cmdlet Get-Help viene dato un cmdlet della shell come argomento, vengono visualizzate le informazioni della Guida per tale cmdlet. Ad esempio, per recuperare le informazioni della Guida per il cmdlet Get-SystemMessage, eseguire il comando riportato di seguito: `Get-Help Get-SystemMessage`
`Get-Help <cmdlet>`	Quando al cmdlet Get-Help viene dato un cmdlet della shell come argomento, insieme a un carattere jolly, il cmdlet Get-Help restituisce un elenco dei cmdlet che corrispondono al testo fornito. È possibile utilizzare più metodi per recuperare un elenco dei cmdlet della shell. Ad esempio: *Get-Help Rules Questo comando restituisce tutti i cmdlet che terminano con la parola `Rules`. Get-Help GetRules* Questo comando restituisce tutti i cmdlet che cominciano con la parola `Get` e terminano con la parola `Rules`. Get-Help Get-Export* Questo comando restituisce tutti i cmdlet che cominciano con la frase `Get-Export`. Utilizzando i caratteri jolly in questo modo, è possibile visualizzare facilmente un elenco dei cmdlet disponibili per una funzionalità specifica. Ad esempio, utilizzando il comando *Get-Help -TransportAgent** è possibile visualizzare un elenco dei verbi del cmdlet disponibili per gli agenti di trasporto.
`Get-Help About_*`	Il comando Get-Help About_* fornisce un elenco degli argomenti generali della Guida di Exchange Management Shell per aiutare a conoscere meglio e utilizzare Exchange Management Shell. Per ulteriori informazioni su un argomento dell'elenco visualizzato, eseguire il comando Get-Help About_<funzionalità>. Ad esempio, per ulteriori informazioni sull'istruzione `Where`, eseguire `Get-Help About_Where`.
`Get-Help <cmdlet> -Detailed`	Vedere la sezione Visualizzazioni della Guida più avanti in questo argomento.
`Get-Help <cmdlet> -Full`	Vedere la sezione Visualizzazioni della Guida più avanti in questo argomento.
`Get-Help <cmdlet> -Examples`	Vedere la sezione Visualizzazioni della Guida più avanti in questo argomento.
`Get-Help <cmdlet> -Parameter <parameter name>`	Vedere la sezione Visualizzazioni della Guida più avanti in questo argomento.
`Get-Help -Role <server role>`	Vedere la sezione Parametri dei ruoli, dei componenti e delle funzionalità più avanti in questo argomento.
`Get-Help -Component <component feature>`	Vedere la sezione Parametri dei ruoli, dei componenti e delle funzionalità più avanti in questo argomento.
`Get-Help -Functionality <Global \| User \| Server>`	Vedere la sezione Parametri dei ruoli, dei componenti e delle funzionalità più avanti in questo argomento.

Nella tabella 2 vengono forniti esempi di come viene utilizzato il cmdlet Get-Command.

Tabella 2 Esempi di utilizzo del comando Get-Command

Cmdlet	Descrizione
`Get-Command`	Il cmdlet Get-Command fornisce un elenco dei cmdlet disponibili per la shell. Come Get-Help, il cmdlet Get-Command consente l'espansione dei caratteri jolly. È possibile utilizzare questo cmdlet con i cmdlet Format-List e Format-Table per fornire una visualizzazione più leggibile. Ad esempio, utilizzare `Get-Command \| Format-List` per visualizzare la Guida dei cmdlet in formato elenco.
`Get-Command <Cmdlet>`	Il comando Get-Command <Cmdlet> fornisce informazioni dettagliate sui parametri e altri componenti del cmdlet specificato. È possibile utilizzare questo comando con i cmdlet Format-List e Format-Table per fornire una visualizzazione più leggibile. Ad esempio, utilizzare `Get-Command Get-SystemMessage \| Format-List` per visualizzare la Guida dei cmdlet in formato elenco.
`Get-Command -Noun <CmdletNoun>`	Il comando Get-Command -Noun <Nome cmdlet> consente di elencare i cmdlet esistenti con il nome specificato. Questo comando è utile se si desidera visualizzare un elenco dei cmdlet associati a una particolare funzionalità. Ad esempio, il comando Get-Help -Noun SystemMessage restituisce i cmdlet disponibili per la funzionalità `SystemMessage`. È possibile utilizzare questo comando con i cmdlet Format-List e Format-Table per fornire una visualizzazione più leggibile. Ad esempio, utilizzare `Get-SystemMessage -Noun Get \| Format-List` per visualizzare la Guida del comando in formato elenco.
`Get-Command -Verb <CmdletVerb>`	Il comando Get-Command -Verb <Verbo cmdlet> consente di elencare i cmdlet esistenti con il verbo specificato. Questo comando è utile se si desidera visualizzare un elenco dei cmdlet associati a una particolare azione. Ad esempio, il comando Get-Help -Verb Enable restituisce i cmdlet disponibili che eseguono l'azione di abilitazione. È possibile utilizzare questo comando con i cmdlet Format-List e Format-Table per fornire una visualizzazione più leggibile. Ad esempio, utilizzare `Get-Command -Verb SystemMessage \| Format-List` per visualizzare la Guida del comando in formato elenco.
`Get-ExCommand`	Il cmdlet Get-ExCommand funziona in modo identico al cmdlet Get-Command, ma restituisce solo i cmdlet disponibili per la gestione di Exchange 2007.
`Get-PSCommand`	Il cmdlet Get-PSCommand funziona in modo identico al cmdlet Get-Command, ma esclude i cmdlet utilizzati per la gestione di Exchange 2007.

Nella tabella 3 vengono forniti esempi su come utilizzare vari comandi della Guida.

Tabella 3 Esempi su come utilizzare vari comandi della Guida

Cmdlet	Descrizione
`QuickRef`	Il comando QuickRef consente di aprire un grafico HTML stampabile in cui sono elencati i cmdlet di Exchange Management Shell utilizzati più frequentemente. Per visualizzare la versione più aggiornata del grafico, vedere Riferimento rapido di Exchange Management Shell.
`<Cmdlet> -?`	Utilizzare il comando <cmdlet> -? insieme a un altro cmdlet per trovare le stesse informazioni della Guida disponibili quando viene utilizzato il cmdlet Get-Help. Ad esempio, digitare `Get-SystemMessage -?` per visualizzare informazioni dettagliate sul cmdlet Get-SystemMessage.
`Get-Tip`	Il cmdlet Get-Tip genera nuovi suggerimenti utili di Exchange Management Shell.
`Get-ExBlog`	Il cmdlet Get-ExBlog consente di aprire Microsoft Internet Explorer per visualizzare il blog del team di Exchange.

Visualizzazioni della Guida

Quando un cmdlet viene specificato come parametro del cmdlet Get-Help, vengono visualizzate le informazioni sulla Guida relative al cmdlet specificato. In alcuni casi, le informazioni restituite possono essere vaste, ma è necessario visualizzare solo informazioni specifiche. Le visualizzazioni della Guida consentono di visualizzare informazioni specifiche relative a un cmdlet senza che sia necessario scorrere informazioni non necessarie.

Exchange Management Shell dispone di quattro visualizzazioni che presentano esattamente le informazioni desiderate. È inoltre possibile recuperare un parametro specifico o un insieme di parametri simili. Nella tabella 4 vengono mostrate le sezioni presenti in ciascuna visualizzazione.

Tabella 4 Visualizzazioni della Guida di Exchange Management Shell

Visualizzazione della Guida	Predefinita	Dettagliata	Completa	Esempi
Sinossi	X	X	X	X
Sintassi	X	X	X
Descrizione dettagliata	X	X	X
Parametri senza metadati		X
Parametri con metadati			X
Tipo di input			X
Tipo restituito			X
Errori			X
Note			X
Esempi		X	X	X
Collegamenti correlati	X		X
Commenti	X	X

Nella tabella 5 viene descritta ciascuna visualizzazione e viene fornito un esempio di comando che la richiama.

Tabella 5 Esempi di visualizzazioni della Guida di Exchange Management Shell

Visualizzazione della Guida	Esempio	Descrizione
`Default`	`Get-Help Set-Mailbox`	La visualizzazione predefinita viene mostrata quando viene utilizzato il comando `Get-Help <`cmdlet`>`.
`Detailed`	`Get-Help Set-Mailbox -Detailed`	La visualizzazione `Detailed` viene mostrata quando viene utilizzato il comando `Get-Help <`cmdlet`> -Detailed`. I parametri restituiti nella sezione `Parameters` non includono i metadati dei parametri. Per ulteriori informazioni sui parametri, vedere Parameters.
`Full`	`Get-Help Set-Mailbox - Full`	La visualizzazione `Full` viene mostrata quando viene utilizzato il comando `Get-Help <`cmdlet`> -Full`. I parametri restituiti nella sezione `Parameters` includono i seguenti metadati dei parametri: `Required?` `Position?` `Default value` `Accept pipeline input?` `Accept wildcard characters?` Per ulteriori informazioni sui parametri, vedere Parameters.
`Examples`	`Get-Help Set-Mailbox -Examples`	La visualizzazione `Examples` viene mostrata quando viene utilizzato il comando `Get-Help <`cmdlet`> -Examples`.

Oltre a queste quattro visualizzazioni della Guida, Exchange Management Shell consente anche di accedere alla descrizione e ai metadati in un parametro specifico o in un insieme di parametri simili. È possibile specificare il parametro insieme al comando Get-Help <cmdlet>. Nel seguente esempio viene descritto come visualizzare la descrizione del parametro ForwardingAddress del cmdlet Set-Mailbox:

Get-Help Set-Mailbox -Parameter ForwardingAddress

È inoltre possibile visualizzare un insieme di parametri esistente in un cmdlet specifico se viene specificato il nome parziale di un parametro insieme a un carattere jolly (*). nel seguente esempio viene descritto come visualizzare tutti i parametri nel cmdlet Set-Mailbox che contengono la parola "Quota":

Get-Help Set-Mailbox -Parameter *Quota*

Nota

Quando si utilizza il parametro Parameter con il cmdlet Get-Help per recuperare le informazioni della Guida per un cmdlet che dispone di un solo parametro, il cmdlet Get-Help non restituisce alcun risultato anche se si utilizza il carattere jolly (*). Questo è un problema noto in Microsoft Windows PowerShell.

Parametri dei ruoli, dei componenti e delle funzionalità

Se viene chiamato il cmdlet Get-Help senza specificare un determinato cmdlet, viene visualizzato un elenco dei cmdlet disponibili in Exchange Management Shell. Tuttavia, potrebbe essere necessario visualizzare un elenco dei cmdlet che consentono di gestire un ruolo del server specifico o una funzionalità di un componente o che riguardano gli oggetti in un determinato ambito della funzionalità. Il cmdlet Get-Help consente di eseguire tali operazioni con tre parametri: Role, Component e Functionality.

Quando viene utilizzato il cmdlet Get-Help con i parametri Role, Component, o Functionality, è necessario racchiudere i valori specificati con tali parametri in caratteri jolly (*). Gli esempi riportati di seguito descrivono come richiamare Get-Help con ciascun parametro:

Get-Help -Role *Mailbox*
Get-Help -Component *Recipient*
Get-Help -Functionality *Server*

Nelle seguenti tabelle vengono elencati i valori che possono essere utilizzati con i parametri Role, Component, e Functionality nel cmdlet Get-Help. Nella tabella 6 vengono elencati i valori che possono essere utilizzati con il parametro Role.

Tabella 6 Valori validi per Get-Help -Role

Ruolo	Valore	Valore alternativo
Cassetta postale	`Mailbox`	`MB`
Trasporto Hub	`Hub`	`HT`
Accesso client	`ClientAccess`	`CA`
Messaggistica unificata	`UnifiedMessaging`	`UM`
Trasporto Edge	`Edge`	`ET`
Amministratore dell'organizzazione	`OrgAdmin`	`OA`
Amministratore del server	`SrvAdmin`	`SV`
Amministratore dei destinatari	`RcptAdmin`	`RA`
Amministratore di Windows	`WinAdmin`	`WA`
Sola lettura	`ReadOnly`	`RO`

Nella tabella 7 vengono elencati i valori che possono essere utilizzati con il parametro Component.

Tabella 7 Valori validi per Get-Help -Component

Valore	Valore
`Addressing`	`Mailflow`
`Agent`	`ManagedFolder`
`Antispam`	`Mobility`
`AutoDiscover`	`OAB`
`Calendaring`	`Outlook`
`Certificate`	`OWA`
`Classification`	`Permission`
`Client`	`Pop`
`Cluster`	`PublicFolder`
`Compliance`	`Queuing`
`Delegate`	`Recipient`
`Diagnostic`	`Routing`
`Domain`	`Rule`
`Extensibility`	`Search`
`FreeBusy`	`Server`
`GAL`	`Statistics`
`Group`	`Storage`
`HighAvailability`	`UM`
`Imap`	`VirtualDirectory`
`Mailbox`

Nella tabella 8 vengono elencati i valori che possono essere utilizzati con il parametro Functionality.

Tabella 8 Valori validi per Get-Help -Functionality

Valore
`Global`
`Server`
`User`

Completamento con TAB

Il completamento con TAB consente di ridurre il testo da digitare quando si utilizza Exchange Management Shell. Quando viene digitato un nome parziale di cmdlet, se viene rilevato un cmdlet corrispondente in Exchange Management, Shell premendo TAB il nome del cmdlet viene completato. Se vengono trovati più nomi di cmdlet corrispondenti, premendo TAB verrà eseguito il ciclo di ciascuno di essi. Quando viene utilizzando il completamento con TAB con i nomi di cmdlet, è necessario fornire almeno il comando e il trattino (-). Nei seguenti esempi viene descritto come utilizzare il completamento con TAB quando viene immesso un nome di cmdlet:

Get-Transport<Tab>
Enable-<Tab>

Nel primo esempio, premendo TAB Exchange Management Shell esegue il ciclo di tutti i nomi di cmdlet che cominciano con Get-Transport. Nel secondo esempio Exchange Management Shell esegue il ciclo dei cmdlet con comando Enable.

Allo stesso modo, è possibile utilizzare il completamento con TAB se si desidera che Exchange Management Shell completi i nomi parziali di parametri che sono stati immessi. Quando viene utilizzato il completamento con TAB con i nomi dei parametri, è necessario specificare il nome completo del cmdlet digitandolo direttamente oppure utilizzando il completamento con TAB. Nei seguenti esempi viene descritto come utilizzare il completamento con TAB quando viene immesso un nome di parametro:

Set-Mailbox -Email<Tab>
New-TransportRule -Cond<Tab>

Nel primo esempio, premendo TAB in Exchange Management Shell viene eseguito il ciclo di tutti i nomi di parametro che cominciano con Email nel cmdlet Set-Mailbox. Nel secondo esempio, premendo TAB in Exchange Management Shell viene completato il parametro Condition nel cmdlet New-TransportRule.