Sintassi

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

Ultima modifica dell'argomento: 2007-02-08

In questo argomento vengono fornite informazioni sulla lettura dei set di parametri di Exchange Management Shell e dei relativi esempi nella documentazione della Guida di Exchange e sulla formattazione di un comando in modo che Exchange Management Shell possa elaborarlo. In Exchange Management Shell, i set di parametri sono visualizzati nella sezione Utilizzo dell'argomento della Guida relativo a un cmdlet. Nel file della Guida di Microsoft Exchange Server 2007, i set di parametri vengono visualizzati nella sezione Sintassi dell'argomento della Guida relativo al cmdlet.

Per ulteriori informazioni relative alla Guida sui cmdlet, vedere Visualizzazione della Guida.

Convenzioni di comando in Exchange Management Shell

Exchange Management Shell si basa su diverse convenzioni di comando che consentono di comprendere quali sono le informazioni necessarie o facoltative quando si esegue un comando e come presentare i parametri e i rispettivi valori. Vedere la sezione Set di parametri più avanti in questo argomento per gli esempi di presentazione dei set di parametri nell Guida di Exchange Management Shell e nel file della Guida di Exchange 2007.

Nella tabella 1 sono elencate le convenzioni di comando.

Tabella 1   Convezioni di comando di Exchange Management Shell

Queste convenzioni di comando consentono di comprendere la struttura di un parametro. Queste convenzioni non si digitano all'inserimento del comando nella riga di comando.

Set di parametri

Nella documentazione della Guida di Exchange, tutti i cmdlet visualizzano i parametri loro associati nei set di parametri. I set di parametri rappresentano raggruppamenti di parametri che è possibile utilizzare tra loro. I parametri presenti un set di parametri e non presenti un altro set di parametri si escludono reciprocamente e non è possibile utilizzarli insieme.

Sebbene a tutti i cmdlet siano associati set di parametri, molti di essi dispongono di un unico set. Ciò significa che è possibile utilizzare tutti i parametri in tale cmdlet tra loro. È possibile che gli altri cmdlet dispongano di diversi set di parametri. Nell'esempio riportato di seguito, sono visualizzati i set di parametri disponibili nel cmdlet New-SystemMessage:

New-SystemMessage -DsnCode <EnhancedStatusCode> -Internal <$true | $false>
-Language <CultureInfo> -Text <String> [-DomainController <String>] [-Templ
ateInstance <MshObject>]

New-SystemMessage -Language <CultureInfo> -QuotaMessageType <WarningMailbox
UnlimitedSize | WarningPublicFolderUnlimitedSize | WarningMailbox | Warning
PublicFolder | ProhibitSendMailbox | ProhibitPostPublicFolder | ProhibitSen
dReceiveMailBox> -Text <String> [-DomainController <String>] [-TemplateInst
ance <MshObject>]

Il cmdlet New-SystemMessage dispone di due set di parametri. Il primo set di parametri contiene i parametri DsnCode e Internal e il secondo set contiene il parametro QuotaMessageType. Ciò significa che è possibile utilizzare insieme i parametri DsnCode e Internal , ma che non è possibile utilizzarli unitamente al parametro QuotaMessageType. Gli altri parametri, Language, Text, DomainController e TemplateInstance, sono elencati in entrambi i set di parametri, per cui è possibile utilizzarli sia con i parametri DsnCode e Internal , sia con il parametro QuotaMessageType.

I set di parametri possono indicare che è possibile utilizzare un singolo cmdlet in più modi. Ad esempio, è possibile utilizzare il cmdlet New-SystemMessage per configurare messaggi DSN (delivery status notification) oppure per configurare messaggi personalizzati sul limite di quota delle cassette postali. Tuttavia, i cmdlet dispongono, in genere, di più set di parametri perché è possibile che un parametro esegua una funzione incompatibile con un altro parametro. Ad esempio, nell'esempio riportato di seguito sono illustrati i set di parametri relativi al cmdlet New-AddressList:

New-AddressList -Name <String> [-Company <MultiValuedProperty>] [-Container
 <AddressListIdParameter>] [-Department <MultiValuedProperty>] [-DisplayNam
e <String>] [-DomainController <String>] [-IncludedRecipients <Nullable>] [
-StateOrProvince <MultiValuedProperty>] [-TemplateInstance <MshObject>]

New-AddressList -Name <String> [-Container <AddressListIdParameter>] [-Disp
layName <String>] [-DomainController <String>] [-RecipientFilter <String>]
[-TemplateInstance <MshObject>] 

Nel cmdlet New-AddressList cmdlet, il primo set di parametri elenca i parametri che consentono di creare un nuovo elenco indirizzi in base ai valori forniti nei parametri Company, Department, IncludedRecipients e StateOrProvice. Tuttavia, è anche possibile creare un nuovo elenco indirizzi utilizzando un filtro personalizzato specificato con il parametro RecipientFilter. Quando si crea un nuovo elenco indirizzi, un filtro personalizzato specificato con il parametro RecipientFilter ignora tutte le configurazioni eseguite con i parametri presenti nel primo set di parametri. Pertanto, il parametro RecipientFilter viene inserito in un proprio set di parametri. Exchange 2007 non consente di specificare entrambi i parametri nella stessa riga di comando. Come nel caso del cmdlet New-SystemMessage, è possibile utilizzare i rimanenti parametri presenti in entrambi i set di parametri del cmdlet New-AddressList con qualsiasi combinazione.

Utilizzo di virgolette

Le virgolette doppie ( " ) vengono più comunemente utilizzate per racchiudere un valore con spazi quando si passa tale valore a un parametro. Se si desidera, ad esempio, passare Contoso Receive Connector al parametro Name del cmdlet Set-ReceiveConnector, è necessario racchiudere Contoso Receive Connector tra virgolette, come nel seguente esempio:

Set-ReceiveConnector -Name "Contoso Receive Connector"

Se non si racchiude la stringa tra virgolette, Exchange Management Shell tenta di interpretare ogni parola come un nuovo argomento nella riga di comando e genera un errore.

In Exchange Management Shell, le virgolette singole ( ' ) e doppie hanno significati diversi. Quando si racchiude una stringa tra virgolette doppie, Exchange Management Shell sostituisce tutte le variabili con un valore corrispondente. Si supponga, ad esempio, che il valore ServerName venga assegnato alla variabile $Server. Si supponga quindi che il seguente comando venga immesso sulla riga di comando:

"$Server Example"

Verrà visualizzato il seguente output:

ServerName Example

Nell'output, la variabile $Server viene sostituita dal valore ServerName.

Quando si racchiude una stringa tra virgolette singole, Exchange Management Shell non tenta di sostituire le variabili con un valore corrispondente. Si supponga che alla variabile $Server venga ancora assegnato il valore ServerName. Si supponga quindi che il seguente comando venga immesso sulla riga di comando:

'$Server-Example'

Verrà visualizzato il seguente output:

$Server-Example

La variabile $Server non è stata sostituita da un valore, poiché Exchange Management Shell non interpreta le variabili incluse in un testo racchiuso tra virgolette singole.

Per ulteriori informazioni sulle variabili, vedere Variabili definite dall'utente e Variabili Shell.

Talvolta può essere necessario anche visualizzare alcuni caratteri, come il segno di dollaro ( $ ), le virgolette singole o doppie o le virgolette rovesciate (  ` ), che hanno significati speciali quando vengono utilizzati in Exchange Management Shell. Per indicare a Exchange Management Shell di non interpretare questi caratteri e di visualizzarli quando sono inclusi in una stringa racchiusa tra virgolette doppie, è necessario utilizzare il carattere di escape virgoletta rovesciata ( ` ). Digitare, ad esempio, il seguente testo sulla riga di comando:

"The price is `$23."

Verrà visualizzato il seguente output:

The price is $23.

Poiché è stato utilizzato il carattere di escape virgoletta rovesciata con il segno di dollaro ( $ ), Exchange Management Shell non interpreta il carattere $ come l'inizio di una variabile.

Se si racchiude una stringa tra virgolette singole, non è necessario inserire alcun carattere di escape, a meno di non voler visualizzare una virgoletta singola in una stringa. Se si desidera visualizzare una virgoletta singola in una stringa racchiusa tra virgolette singole, è necessario utilizzare due virgolette singole ( '' ). Digitare, ad esempio, il seguente testo sulla riga di comando:

'Don''t confuse two single quotation marks with a double quotation mark!'

Verrà visualizzato il seguente output:

Don't confuse two single quotation marks with a double quotation mark!

Operatori di comando in Exchange Management Shell

Utilizzare gli operatori elencati nella tabella 2 quando si digitano comandi in Exchange Management Shell. È possibile che alcuni operatori corrispondano ad alcune delle convenzioni di comando indicate in precedenza, sebbene non abbiano lo stesso significato quando sono digitati nella riga di comando. La tabella 2 elenca gli operatori validi che è possibile utilizzare in un comando.

Tabella 2   Operatori di comando di Exchange Management Shell