Exchange cmdlet 구문

 

적용 대상:Exchange Online, Exchange Online Protection, Exchange Server 2016, Office 365 Security & Compliance Center

마지막으로 수정된 항목:2015-11-30

Exchange, Exchange Online, Exchange Online Protection 및 Office 365 보안 및 준수 센터의 cmdlet 구조와 구문에 대해 알아봅니다.

Exchange cmdlet 참조 항목은 cmdlet의 주요 측면을 설명하는 표준화된 메서드를 사용합니다. 예를 들면 다음과 같습니다.

  • cmdlet에서 사용할 수 있는 매개 변수입니다.

  • 각 매개 변수에서 허용하는 값입니다.

  • 함께 사용할 수 있는 매개 변수 및 개별적으로 사용해야 하는 매개 변수입니다.

이 항목에서는 이러한 규칙과 ExchangePowerShell에서 명령을 실행하는 데 필요한 구문을 설명합니다.

목차

Exchange PowerShell의 명령 규칙

Exchange PowerShell의 매개 변수 집합

Exchange PowerShell의 따옴표

Exchange PowerShell의 이스케이프 문자

Exchange PowerShell의 명령 연산자

Exchange PowerShell 도움말은 필수 항목 또는 옵션 항목과, 명령을 실행할 때 매개 변수 및 값을 입력하는 방법을 나타내는 규칙을 따릅니다. 이러한 명령 규칙이 다음 표에 나와 있습니다.

 

기호 설명

-

하이픈은 매개 변수를 나타냅니다. 예: -Identity.

< >

꺾쇠 괄호는 매개 변수에 사용 가능한 값을 나타냅니다. 예: -Location <ServerName> 또는 -Enabled <$true | $false>.

[ ]

대괄호는 선택적 매개 변수와 해당 값을 나타냅니다. 예: [-WhatIf <SwitchParameter>].

대괄호로 묶이지 않은 매개 변수-값 쌍이 필요합니다.

|

매개 변수 값에서 파이프 기호는 값 사이의 선택 항목을 나타냅니다. 예를 들어 -Enabled <$true | $false>Enabled 매개 변수에 $true 또는 $false 값을 사용할 수 있음을 나타냅니다.

이러한 명령 규칙은 명령 작성 방법을 이해하는 데 도움이 됩니다. Exchange PowerShell에서 cmdlet을 실행할 때 표에 설명된 대로 매개 변수를 나타내는 하이픈을 제외하고는 이러한 기호를 사용하지 마세요.

매개 변수 집합은 같은 명령에서 함께 사용할 수 있는 매개 변수 그룹입니다. 다른 매개 변수 집합에 있는 매개 변수는 같은 명령에 함께 사용할 수 없습니다.

많은 cmdlet에는 오직 하나의 매개 변수 집합만 있습니다. 즉, 사용 가능한 모든 매개 변수를 함께 사용할 수 있습니다. 다른 cmdlet에는 여러 개의 매개 변수 집합이 있습니다. 즉, 일부 매개 변수는 다른 매개 변수와 호환되지 않는 기능을 수행합니다. 예를 들어 다음 매개 변수 집합을 New-SystemMessage cmdlet에서 사용할 수 있다고 가정하겠습니다.

New-SystemMessage -DsnCode <EnhancedStatusCode> -Internal <$true | $false> -Language <CultureInfo> -Text <String> <COMMON PARAMETERS> 
 
New-SystemMessage -Language <CultureInfo> -QuotaMessageType <WarningMailboxUnlimitedSize | WarningPublicFolderUnlimitedSize | WarningMailbox | WarningPublicFolder | ProhibitSendMailbox | ProhibitPostPublicFolder | ProhibitSendReceiveMailBox> -Text <String> <COMMON PARAMETERS> 
 
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

이 cmdlet에는 두 가지 별도의 매개 변수 집합이 있습니다. 즉, 다음 매개 변수를 같은 명령에서 함께 사용할 수 있습니다.

  • DsnCode

  • Internal

  • Language

  • Text

또한 다음 매개 변수도 같은 명령에서 함께 사용할 수 있습니다.

  • Language

  • QuotaMessageType

  • Text

하지만 다음 매개 변수는 같은 명령에서 함께 사용할 수 없습니다.

  • DsnCodeQuotaMessageType.

  • InternalQuotaMessageType.

COMMON PARAMETERS 섹션에는 모든 매개 변수 집합의 매개 변수와 함께 사용할 수 있는 매개 변수(일반적으로 선택적 매개 변수)가 포함되어 있습니다. 예를 들면 Confirm 매개 변수는 DsnCodeQuotaMessageType 매개 변수가 서로 다른 집합에 있음에도 불구하고 이러한 변수와 함께 사용할 수 있습니다.

Exchange PowerShel에서는 작은따옴표(') 또는 큰따옴표(")를 사용하여 공백이 포함된 매개 변수 값을 묶습니다. 예를 들어 다음 명령은 동일하게 작동합니다.

  • Get-ReceiveConnector -Identity "Contoso Receive Connector"

  • Get-ReceiveConnector -Identity 'Contoso Receive Connector'

Contoso Receive Connector 값을 따옴표로 묶지 않으면 Exchange PowerShell에서 각 단어를 새 인수로 처리하려고 하므로 명령이 실패합니다. 이 예제에서는 다음과 같은 오류가 표시됩니다.

A positional parameter cannot be found that accepts argument 'Receive'

값에 변수가 포함된 경우 작은따옴표와 큰따옴표를 신중하게 선택해야 합니다. 예를 들어 Mailbox01 값을 갖는 $Server 변수가 있다고 가정하겠습니다.

  • 큰따옴표   변수가 해당 값으로 대체됩니다. "$Server Example" 입력 시 Mailbox01 Example이 출력됩니다.

  • 작은따옴표   변수가 문자 그대로 처리됩니다. '$Server Example' 입력 시 $Server Example이 출력됩니다.

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

모든 프로그래밍 언어에서 이스케이프 문자는 특수 문자를 문자 그대로 식별하는 데 사용되며, 해당 언어의 일반 기능에 따라 사용되지 않습니다. Exchange PowerShell에서 문자열을 큰따옴표로 묶는 경우 이스케이프 문자가 역따옴표 이스케이프 문자( ` )입니다.

예를 들어 The price is $23를 출력하려면 "The price is `$23" 값을 입력합니다. 달러 기호 문자($)는 Exchange PowerShell에서 변수를 정의하므로 이스케이프 문자가 필요합니다.

문자를 작은따옴표로 묶는 경우 주의해야 하는 유일한 특수 문자는 바로 작은따옴표 문자입니다. 이때에는 작은따옴표가 두 개 필요합니다( '' ).

예를 들어 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 PowerShell의 명령 규칙 섹션에서 설명했습니다. 그러나 이러한 기호는 명령줄에서 연산자로 사용될 경우 다른 의미를 갖습니다. 예를 들면 매개 변수를 나타내는 데 사용되는 빼기 기호는 명령에 수학 연산자로 사용될 수도 있습니다.

 

연산자 설명

=

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

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

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

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

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

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

:

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

!

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

[ ]

대괄호는 배열 위치의 인덱스 값을 지정하는 데 사용됩니다. 인덱스 값은 0에서 시작하는 오프셋입니다. 예를 들어 $Red[9]$Red 배열의 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 -Server SRV1 | Set-Mailbox -ProhibitSendQuota 2GB).

>

오른쪽 꺾쇠 괄호는 명령 출력을 파일로 보내는 데 사용되며, 파일 내용을 덮어씁니다 (예: Get-TransportRulePredicate > "C:\My Documents\Output.txt").

>>

오른쪽 이중 꺾쇠 괄호는 명령 출력을 기존 파일에 추가하는 데 사용됩니다. 파일이 없으면 새 파일이 만들어집니다 (예: Get-TransportRulePredicate >> "C:\My Documents\Output.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" * 3TestTestTest와 같습니다.

/

/ 연산자는 하나의 값을 다른 값으로 나눕니다. 예를 들면 6 / 61과 같습니다.

%

숫자 평가에서 % 연산자는 나누기 연산의 나머지를 반환합니다. 예를 들면 6 % 42과 같습니다.

파이프라인에서 퍼센트 문자( % )는 ForEach-Object cmdlet을 줄인 것입니다. 예를 들면 Import-Csv c:\MyFile.csv | ForEach-Object {Set-Mailbox $_.Identity -Name $_.Name}Import-Csv c:\MyFile.csv | % {Set-Mailbox $_.Identity -Name $_.Name}과 같습니다.

자세한 내용은 파이프라인를 참조하십시오.

?

물음표 문자(?)는 Where-Object cmdlet을 줄인 것입니다. 예를 들면 Get-Alias | Where-Object {$_.Definition -eq "Clear-Host"}Get-Alias | ? {$_.Definition -eq "Clear-Host"}과 같습니다.

 
표시: