구문

  • 아티클

 

적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

마지막으로 수정된 항목: 2007-02-08

이 항목에서는 Exchange 도움말 문서의 Exchange 관리 셸 매개 변수 집합 및 예를 읽는 방법과 Exchange 관리 셸에서 명령을 처리할 수 있도록 명령 서식을 지정하는 방법에 대해 설명합니다. Exchange 관리 셸에서 매개 변수 집합은 cmdlet 도움말 항목의 사용 섹션에 표시됩니다. Microsoft Exchange Server 2007 도움말 파일에서 매개 변수 집합은 cmdlet 도움말 항목의 구문 섹션에 표시됩니다.

cmdlet 도움말에 대한 자세한 내용은 도움말 보기를 참조하십시오.

Exchange 관리 셸의 명령 규칙

Exchange 관리 셸은 명령 실행 시 필수 또는 선택인 정보와 매개 변수 및 그 값을 표시하는 방법에 대한 이해를 돕는 여러 명령 규칙을 따릅니다. Exchange 관리 셸 도움말 및 Exchange 2007 도움말 파일에서 매개 변수 집합 표시 방법의 예에 대한 내용은 나중에 이 항목에서 설명하는 매개 변수 집합 섹션을 참조하십시오.

표 1에서는 이러한 명령 규칙을 보여줍니다.

표 1   Exchange 관리 셸 명령 규칙

기호 설명

-

하이픈은 명령줄의 다음 단어가 매개 변수임을 나타냅니다. 가장 일반적인 매개 변수는 Identity입니다. 매개 변수에 대한 자세한 내용은 매개 변수를 참조하십시오.

< >

꺾쇠 괄호는 매개 변수 값을 묶는 데 사용됩니다. 이러한 값은 선택 또는 이름일 수 있습니다. 예를 들어 -Parameter1 <1 | 2 | 3>에서 숫자는 특정 값 선택을 나타냅니다. -Parameter2 <ServerName>에서 ServerName은 실제 값을 나타냅니다.

[ ]

대괄호는 선택적 매개 변수와 해당 값을 묶는 데 사용됩니다. 따라서 대괄호로 묶이지 않은 매개 변수와 해당 값이 필요합니다.

|

-Parameter1 <1 | 2 | 3>과 같이 파이프 기호가 매개 변수 값 목록에 사용되는 경우 이 기호는 사용 가능한 값 간의 선택을 나타냅니다. 이러한 규칙은 System.Enum 매개 변수와 System.Boolean 매개 변수에 적용됩니다.

이러한 명령 규칙은 명령 구성 방법을 이해하는 데 도움이 됩니다. 명령줄에 명령을 입력할 때 이러한 규칙을 입력하지 않습니다.

매개 변수 집합

Exchange 도움말 문서에서 모든 cmdlet는 매개 변수 집합의 관련 매개 변수를 표시합니다. 매개 변수 집합은 함께 사용할 수 있는 매개 변수 그룹입니다. 하나의 매개 변수 집합에 포함되었으나 다른 매개 변수 집합에는 포함되지 않은 매개 변수는 상호 배타적이므로 함께 사용할 수 없습니다.

모든 cmdlet에 매개 변수 집합이 있지만 많은 cmdlet에 하나의 매개 변수 집합만 있습니다. 즉 해당 cmdlet의 모든 매개 변수를 함께 사용할 수 있습니다. 그 외의 cmdlet에는 여러 매개 변수 집합이 있을 수 있습니다. 다음 예는 New-SystemMessage cmdlet에서 사용할 수 있는 매개 변수 집합을 보여줍니다.

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 cmdlet에는 두 개의 매개 변수 집합이 있습니다. 첫 번째 매개 변수 집합은 DsnCode 매개 변수와 Internal 매개 변수를 포함하고 두 번째 매개 변수 집합은 QuotaMessageType 매개 변수를 포함합니다. 즉 DsnCode 매개 변수와 Internal 매개 변수 는 함께 사용할 수 있지만 이러한 매개 변수를 QuotaMessageType 매개 변수와는 함께 사용할 수 없습니다. 나머지 매개 변수인 Language, Text, DomainController 및 TemplateInstance는 두 매개 변수 집합에 모두 포함됩니다. 그러므로 해당 매개 변수를 DsnCode 매개 변수 및 Internal 매개 변수 그리고 QuotaMessageType 매개 변수와 함께 사용할 수 있습니다.

매개 변수 집합은 단일 cmdlet를 여러 경우에 사용할 수 있음을 나타냅니다. 예를 들어 New-SystemMessage cmdlet를 사용하여 사용자 지정 DSN(배달 상태 알림) 메지지를 구성하거나 사용자 지정 사서함 할당량 제한 메시지를 구성할 수 있습니다. 그러나 하나의 매개 변수가 다른 매개 변수와 호환되지 않는 기능을 수행할 수 있으므로 일반적으로 cmdlet에는 여러 매개 변수 집합이 있습니다. 예를 들어 다음 예는 New-AddressList cmdlet의 매개 변수 집합을 보여줍니다.

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 cmdlet에서 첫 번째 매개 변수 집합에는 Company, Department, IncludedRecipients 및 StateOrProvice 매개 변수에 제공된 값을 기준으로 새 주소 목록을 만들 수 있는 매개 변수가 나열됩니다. 그러나 RecipientFilter 매개 변수로 지정된 사용자 지정 필터를 사용하여 새 주소 목록을 만들 수도 있습니다. 새 주소 목록을 만드는 경우 RecipientFilter 매개 변수를 사용하여 지정된 사용자 지정 필터는 첫 번째 매개 변수 집합에 있는 매개 변수를 사용하여 구성된 것을 모두 다시 정의합니다. 따라서 RecipientFilter 매개 변수는 자체 매개 변수 집합에 포함됩니다. Exchange 2007에서는 동일한 명령줄에서 두 매개 변수를 모두 지정할 수 없습니다. New-SystemMessage cmdlet에서와 같이 New-AddressList cmdlet의 두 매개 변수 집합에 있는 나머지 매개 변수를 조합하여 사용할 수 있습니다.

따옴표 사용

큰따옴표(")는 공백이 있는 특정 값을 매개 변수로 전달할 때 해당 값을 묶는 데 일반적으로 사용됩니다. 예를 들어 Contoso Receive Connector를 Set-ReceiveConnector cmdlet의 Name 매개 변수로 전달하려는 경우 다음 예제와 같이 Contoso Receive Connector를 큰따옴표로 묶어야 합니다.

Set-ReceiveConnector -Name "Contoso Receive Connector"

이 문자열을 따옴표로 묶지 않으면 Exchange 관리 셸에서 문자열의 각 단어를 명령줄에서 새 인수로 해석하려 하므로 오류가 표시됩니다.

Exchange 관리 셸에서 큰따옴표와 작은따옴표(')의 의미는 서로 다릅니다. 문자열을 큰따옴표로 묶으면 Exchange 관리 셸에서 모든 변수를 일치하는 값으로 대체합니다. 예를 들어 ServerName 값이 $Server 변수에 할당되는 경우 다음 명령을 명령줄에 입력한다고 가정합시다.

"$Server Example"

그러면 다음 출력이 표시됩니다.

ServerName Example

즉, $Server 변수는 출력에서 ServerName 값으로 대체됩니다.

반면 문자열을 작은따옴표로 묶으면 Exchange 관리 셸에서는 변수를 일치하는 값으로 대체하지 않습니다. 위 예제와 마찬가지로 $Server 변수에 ServerName 값이 할당되는 경우 다음 명령을 명령줄에 입력한다고 가정합시다.

'$Server-Example'

그러면 다음 출력이 표시됩니다.

$Server-Example

즉, Exchange 관리 셸에서 작은따옴표로 묶인 텍스트에 포함된 변수를 해석하지 않으므로 $Server 변수는 값으로 대체되지 않습니다.

변수에 대한 자세한 내용은 사용자 정의 변수 및 셸 변수를 참조하십시오.

달러 기호($ ), 큰따옴표나 작은따옴표 또는 역따옴표( ` ) 등의 문자를 표시하려는 경우도 있습니다. 이러한 문자를 Exchange 관리 셸에서 사용하는 경우 특수한 의미가 있습니다. Exchange 관리 셸에서 이러한 문자를 해석하지 않고 큰따옴표로 묶인 문자열에 포함되어 있는 해당 문자를 표시하도록 하려면 역따옴표 이스케이프 문자( ` )를 사용해야 합니다. 예를 들어 명령줄에 다음 텍스트를 입력하십시오.

"The price is `$23."

그러면 다음 출력이 표시됩니다.

The price is $23.

여기서 달러 기호($ )와 함께 역따옴표 이스케이프 문자를 사용했으므로 Exchange 관리 셸에서 $를 변수의 시작으로 해석하지 않습니다.

문자열을 작은따옴표로 묶으면 문자열에 작은따옴표를 표시하려는 경우를 제외하고는 이스케이프 문자를 사용할 필요가 없습니다. 작은따옴표로 묶인 문자열에 작은따옴표를 표시하려는 경우에는 작은따옴표 두 개('')를 사용해야 합니다. 예를 들어 명령줄에 다음 텍스트를 입력하십시오.

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

그러면 다음 출력이 표시됩니다.

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

Exchange 관리 셸의 명령 연산자

Exchange 관리 셸에서 명령을 입력하는 경우 표 2의 연산자를 사용합니다. 일부 연산자는 이전에 언급한 일부 명령 규칙과 일치할 수 있습니다. 그러나 이러한 연산자를 명령줄에 입력하는 경우 명령 규칙과 동일한 기능을 하는 것은 아닙니다. 표 2에서는 명령에 사용할 수 있는 유효한 연산자를 보여줍니다.

표 2   Exchange 관리 셸 명령 연산자

연산자 설명

=

등호는 할당 문자로 사용됩니다. 등호 오른쪽의 값은 등호 왼쪽의 변수에 할당됩니다. 다음 문자도 할당 문자입니다.

  • +=   등호 오른쪽의 값을 등호 왼쪽의 변수에 포함된 현재 값에 더합니다.

  • -=   등호 오른쪽의 값을 등호 왼쪽의 변수에 포함된 현재 값에서 뺍니다.

  • *=   등호 왼쪽에 있는 변수의 현재 값을 등호 오른쪽에서 지정한 값으로 곱합니다.

  • /=   등호 왼쪽에 있는 변수의 현재 값을 등호 오른쪽에서 지정한 값으로 나눕니다.

  • %=   등호 왼쪽에 있는 변수의 현재 값을 등호 오른쪽에서 지정한 값으로 수정합니다.

:

콜론은 다음 예에서와 같이 매개 변수 이름과 값을 구분하는 데 사용됩니다. -Enabled:$True. 콜론은 스위치 매개 변수를 제외한 모든 매개 변수 유형에서 선택적으로 사용할 수 있습니다. 스위치 매개 변수에 대한 자세한 내용은 매개 변수를 참조하십시오.

!

느낌표는 논리적 NOT 연산자입니다. 등호(= ) 기호와 함께 사용하는 경우 조합된 쌍은 "같지 않음"을 의미합니다.

[ ]

대괄호는 배열 위치의 인덱스 값을 지정하는 데 사용됩니다. 예를 들어 $Red[9] 는 $Red 배열의 10번째 인덱스 위치를 나타냅니다. 배열 인덱스가 영(0)부터 시작하기 때문에 10번째 인덱스 위치를 나타냅니다.

$A=[XML] "<Test><A>value</A></Test>" 예에서와 같이 대괄호는 변수에 유형을 할당하는 데 사용될 수도 있습니다. 다음 유형을 할당할 수 있습니다. Array, Bool, Byte, Char, Char[], Decimal, Double, Float, Int, Int[], Long, Long[], RegEx, Single, ScriptBlock, String, Type 및 XML.

{ }

중괄호는 다음 예에서와 같이 명령에 식을 포함하는 데 사용됩니다. Get-Process | Where { $_.HandleCount -gt 400 }

|

파이프 기호는 하나의 cmdlet에서 다른 cmdlet로 결과를 파이프하는 데 사용됩니다. 예를 들어 다음 명령은 Get-Mailbox cmdlet의 결과를 Move-Mailbox cmdlet로 파이프합니다. Get-Mailbox -Server SRV1 | Move-Mailbox -TargetDatabase SRV2

>

오른쪽 꺾쇠 괄호는 다음 예에서와 같이 명령 출력을 파일로 보내는 데 사용됩니다. Get-TransportRulePredicate > c:\out.txt. 따라서 대상 파일을 덮어씁니다.

>>

파일이 있으면 오른쪽 이중 꺾쇠 괄호는 명령 출력을 파일에 추가하는 데 사용됩니다. 파일이 없으면 새 파일이 생성됩니다. 다음은 오른쪽 이중 꺾쇠 괄호 사용 방법에 대한 예입니다. Get-TransportRulePredicate >>c:\out.txt

" "

따옴표는 공백을 포함한 문자열을 묶는 데 사용됩니다.

$

달러 기호는 변수를 나타냅니다. 예를 들어 $Blue = 10은 값 10을 변수 $Blue에 할당합니다.

@

@ 기호는 결합형 배열을 참조합니다. 자세한 내용은 배열를 참조하십시오.

$( )

괄호로 묶인 달러 기호($)는 명령 대체를 나타냅니다. 다음 예에서와 같이 하나의 명령 출력을 다른 명령의 인수로 사용하려는 경우 명령 대체를 사용할 수 있습니다. Get-ChildItem $(Read-Host -Prompt "Enter FileName: ")

..

이중 마침표는 값 범위를 나타냅니다. 예를 들어 배열에 여러 인덱스가 포함된 경우 다음 예에서와 같이 명령을 지정하여 두 번째와 다섯 번째 인덱스 사이의 모든 인덱스 값을 반환할 수 있습니다. $Blue[2..5]

+

+ 연산자는 두 값을 함께 더합니다. 예: 6 + 6=12

-

- 연산자는 하나의 값을 다른 값에서 뺍니다. 예: 12 - 6=6

또한 - 연산자는 -6과 같이 음수를 나타내는 데 사용될 수 있습니다. 예: -6 * 6=-36

*

와일드카드 문자에는 여러 의미가 있습니다. 와일드카드 문자를 사용하여 문자열 일치 또는 숫자 값 곱하기를 수행할 수 있고 문자열과 숫자 값을 함께 사용하는 경우에는 다음 예에서와 같이 숫자 값으로 지정된 횟수 만큼 문자열 값을 반복할 수 있습니다. 예: "Test" * 3 =TestTestTest

/

/ 연산자는 하나의 값을 다른 값으로 나눕니다. 예: 6 / 6 =1

%

% 연산자는 나누기 연산자의 나머지 값을 반환합니다. 예: , 6 % 4 =2