Condividi tramite


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

Simbolo Descrizione

-

Un trattino indica che la parola successiva nella riga di comando corrisponde a un parametro. Il parametro più comune è rappresentato da Identity. Per ulteriori informazioni sui parametri, vedere Parameters.

< >

Le parentesi angolari sono utilizzate per racchiudere i valori del parametro. Questi valori sono rappresentati da opzioni o da nomi. Ad esempio, nel parametro -Parameter1 <1 | 2 | 3>, i numeri rappresentano opzioni del valore specifico, mentre, nel parametro -Parameter2 <ServerName>, ServerName rappresenta il valore effettivo.

[ ]

Le parentesi quadre sono utilizzate per racchiudere un parametro facoltativo e il rispettivo valore. Sono necessari un parametro e il relativo valore non racchiusi in parentesi quadre.

|

Quando si utilizza questo simbolo in un elenco di valori del parametro, ad esempio -Parameter1 <1 | 2 | 3>, si indica un'opzione tra valori disponibili. Questa convezione si applica ai parametri di System.Enum e di System.Boolean.

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

Operatore Descrizione

=

Il segno uguale è utilizzato come carattere di assegnazione. Il valore posto alla destra del segno uguale viene assegnato alla variabile alla sua sinistra. Anche i caratteri riportati di seguito sono considerati caratteri di assegnazione:

  • +=   Aggiunge il valore posto alla destra del segno uguale al valore corrente contenuto nella variabile posta alla sinistra di tale segno.

  • -=   Sottrae il valore posto alla destra del segno uguale dal valore corrente contenuto nella variabile posta alla sinistra di tale segno.

  • *=   Moltiplica il valore corrente della variabile posta alla sinistra del segno uguale per il valore corrente specificato alla destra di tale segno.

  • /=   Divide il valore corrente della variabile posta alla sinistra del segno uguale per il valore corrente specificato alla destra di tale segno.

  • %=   Modifica il valore corrente della variabile posta alla sinistra del segno uguale per il valore corrente specificato alla destra di tale segno.

:

È possibile utilizzare i due punti per separare il nome di un parametro dal rispettivo valore, come nell'esempio seguente: -Enabled:$True. L'utilizzo dei due punti è facoltativo in tutti i tipi di parametri tranne che nei parametri di opzione. Per ulteriori informazioni sui parametri di opzione, vedere Parameters.

!

Il punto esclamativo rappresenta l'operatore logico NOT. Quando è utilizzato insieme al segno uguale ( ), la coppia combinata significa "non uguale a".

[ ]

Le parentesi quadre sono utilizzate per specificare il valore indice della posizione di una matrice. Ad esempio, l'indicazione $Red[9] si riferisce alla decima posizione indice della matrice nella matrice $Red. Fa riferimento alla decima posizione indice perché gli indici di matrice iniziano con zero ( 0 ).

Inoltre, è possibile utilizzare le parentesi quadre per assegnare un tipo a una variabile, ad esempio nella variabile $A=[XML] "<Test><A>value</A></Test>". Sono validi i tipi indicati di seguito: Array, Bool, Byte, Char, Char[], Decimal, Double, Float, Int, Int[], Long, Long[], RegEx, Single, ScriptBlock, String, Type e XML..

{ }

Le parentesi graffe sono utilizzate per includere un espressione in un comando, come nell'esempio: Get-Process | Where { $_.HandleCount -gt 400 }

|

Questo simbolo è utilizzato quando un cmdlet esegue il piping di un risultato a un altro cmdlet. Ad esempio, il comando riportato di seguito esegue il piping dei risultati dal cmdlet Get-Mailbox al cmdlet Move-Mailbox: Get-Mailbox -Server SRV1 | Move-Mailbox -TargetDatabase SRV2

>

La parentesi angolata verso destra è utilizzata per inviare l'output di un comando a un file, come nell'esempio seguente: Get-TransportRulePredicate > c:\out.txt. Il file di destinazione viene sovrascritto.

>>

Le doppie parentesi angolate verso destra sono utilizzate per aggiungere l'output di un comando a un file, se tale file è disponibile. Se il file non è disponibile, viene creato un nuovo file. Di seguito, è riportato un esempio di utilizzo delle doppie parentesi angolate verso destra: Get-TransportRulePredicate >>c:\out.txt

" "

Le virgolette sono utilizzate per racchiudere una stringa contenente spazi.

$

Il segno del dollaro indica una variabile. Ad esempio, $Blue = 10 assegna il valore 10 alla variabile $Blue.

@

Il simbolo @ fa riferimento a una matrice associativa. Per ulteriori informazioni, vedere Matrici.

$( )

Un segno del dollaro ( $ ) con parentesi indica la sostituzione di un comando. È possibile utilizzare la sostituzione di un comando quando si desidera utilizzare l'output di un comando come argomento in un altro comando, come nell'esempio seguente: Get-ChildItem $(Read-Host -Prompt "Enter FileName: ")

..

I punti doppi indicano un intervallo di valori. Ad esempio, se una matrice include diversi indici, è possibile specificare il comando indicato di seguito per ottenere i valori di tutti gli indici tra il secondo e il quinto indice, come nell'esempio seguente: $Blue[2..5]

+

L'operatore + esegue la somma di due valori. Ad esempio, 6 + 6 è uguale a 12.

-

L'operatore - esegue la sottrazione tra due valori. Ad esempio, 12 - 6 è uguale a 6.

L'operatore -, inoltre, può essere utilizzato per rappresentare un numero negativo come -6. Ad esempio, -6 * 6 è uguale a -36.

*

Un carattere jolly ha diversi significati. È possibile utilizzare i caratteri jolly per la corrispondenza di stringhe, per la moltiplicazione di valori numerici oppure, se le stringhe e i valori numerici sono utilizzati insieme, per la ripetizione del valore della stringa per il numero di volte specificato dal valore numerico, ad esempio: "Test" * 3 è uguale a TestTestTest.

/

L'operatore / esegue la divisione di un valore per un altro. Ad esempio, 6 / 6 è uguale a 1.

%

L'operatore % restituisce il resto di un operatore di divisione. Ad esempio, , 6 % 4 è uguale a 2.