В среде управления Exchange используется ряд соглашений о записи команд, зная которые, проще понять, какие данные являются обязательными и необязательными при выполнении команды и как надо указывать параметры и их значения. Примеры записи наборов параметров в справке среды управления Exchange и файле справки Exchange 2007 см. в подразделе «Наборы параметров» ниже в этом разделе.

В таблице 1 приводятся соглашения о записи команд.

Таблица 1. Соглашения о записи команд в среде управления Exchange

Эти соглашения о записи команд помогут понять структуру команды. Символы, используемые при описании синтаксиса, в командной строке не вводятся.

В справочной документации Exchange параметры всех командлетов отображаются в наборах параметров. Наборы параметров представляют собой группы параметров, которые можно использовать друг с другом. Параметры, которые указаны в одном наборе параметров, однако отсутствуют в другом наборе, являются взаимоисключающими. Их нельзя использовать одновременно.

Хотя все командлеты имеют наборы параметров, у многих из них есть только один набор параметров. Это означает, что все параметры такого командлета могут использоваться в сочетании друг с другом. Для других командлетов доступно несколько наборов параметров. В следующем примере показаны наборы параметров, доступные для командлета 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>]

Командлет New-SystemMessage имеет два набора параметров. Первый набор параметров содержит параметры DsnCode и Internal, а второй набор параметров — параметр QuotaMessageType. Это означает, что параметры DsnCode и Internal могут использоваться одновременно. Однако их нельзя использовать, если указан параметр QuotaMessageType. Остальные параметры, Language, Text, DomainController и TemplateInstance, присутствуют в обоих наборах параметров. Это означает, что они могут использоваться как с параметрами DsnCode, так и Internal, а также с параметром QuotaMessageType.

Наборы параметров свидетельствуют, что один и тот же командлет можно использовать в нескольких целях. Например, с помощью командлета New-SystemMessage можно настраивать собственные уведомления о состоянии доставки или собственные сообщения о квоте почтового ящика. Однако командлеты обычно имеют несколько наборов параметров в связи с тем, что один из параметр задает выполнение функции, несовместимой с другим параметром. Так, в следующем примере показаны наборы параметров для командлета 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>]

В командлете New-AddressList первый набор параметров содержит параметры, с помощью которых можно создать список адресов на основе значений, указанных в параметрах Company, Department, IncludedRecipients и StateOrProvice. Однако список адресов также можно создать с помощью настраиваемого фильтра, который определяется параметром RecipientFilter. При создании списка адресов настраиваемый фильтр, указанный с помощью параметра RecipientFilter, переопределяет настройку, заданную с использованием параметров первого набора. Поэтому параметр RecipientFilter помещен в отдельный набор параметров. В Exchange 2007 нельзя указать взаимоисключающие параметры в одной командной строке. Как и в случае с командлетом New-SystemMessage, остальные параметры, включенные в оба набора параметров в командлете New-AddressList, могут использоваться в любом сочетании.

В прямые кавычки (") чаще всего заключаются значения с пробелами, которые передаются параметру. Например, если необходимо передать значение Contoso Receive Connector параметру Name командлета Set-ReceiveConnector, значение Contoso Receive Connector необходимо заключить в кавычки, как показано в следующем примере:

	Копировать код
Set-ReceiveConnector -Name "Contoso Receive Connector"

Если строка не заключена в кавычки, командная консоль Exchange пытается интерпретировать каждое слово в строке как новый аргумент командной строки и выводит сообщение об ошибке.

Прямые кавычки и апострофы (') имеют в командной консоли Exchange разное значение. Если строка заключена в прямые кавычки, командная консоль Exchange заменяет все переменную соответствующими значениями. Допустим, например, что переменной $Server присвоено значение ServerName. В командной строке вводится следующая команда:

	Копировать код
"$Server Example"

Выводится следующий результат:

	Копировать код
ServerName Example

Переменная $Server заменяется при выводе значением ServerName.

Если строка заключена в апострофы, командная консоль Exchange не пытается заменять переменные соответствующим значением. Допустим, что переменной $Server присвоено значение ServerName. В командной строке вводится следующая команда:

	Копировать код
'$Server-Example'

Выводится следующий результат:

	Копировать код
$Server-Example

Переменная $Server не была заменена значением, так как командная консоль Exchange не интерпретирует переменные в тексте, заключенном в апострофы.

Дополнительные сведения о переменных см. в разделах Пользовательские переменные и Переменные среды.

Также может потребоваться отображение некоторых знаков, таких как знак доллара ( $ ), прямые кавычки, апострофы или обратный апостроф ( ` ). Эти знаки имеют специальное значение при использовании в командной консоли Exchange. Чтобы командная консоль Exchange не интерпретировала эти знаки, а выводила их в строке, заключенной в прямые кавычки, необходимо использовать escape-знак обратного апострофа ( ` ). Например, введите в командной строке следующую команду:

	Копировать код
"The price is `$23."

Выводится следующий результат:

	Копировать код
The price is $23.

Так как со знаком доллара ( $ ) использовался escape-знак обратного апострофа, командная консоль Exchange не интерпретировала $ как начало переменной.

Если строка заключена в апострофы, для отображения любых знаков, кроме апострофа, не нужно использовать escape-знак. Если в строке, заключенной в апострофы, необходимо отобразить апостроф, используйте два апострофа ( '' ). Например, введите в командной строке следующую команду:

	Копировать код
'Don''t confuse two single quotation marks with a double quotation mark!'

Выводится следующий результат:

	Копировать код
Don't confuse two single quotation marks with a double quotation mark!

Операторы, приведенные в таблице 2, используются при вводе команд в среде управления Exchange. Некоторые из этих операторов могут совпадать с символами, указанными выше в соглашениях о записи команд. Однако в командной строке они имеют другое значение. В таблице 2 показаны допустимые операторы, которые можно использовать в команде.

Таблица 2. Командные операторы среды управления Exchange