Exchange cmdlet 구문Exchange cmdlet syntax

Cmdlet에 대 한 주요 측면을 설명 하는 표준화 된 메서드를 사용 하는 Exchange cmdlet 참조 항목입니다. 예를 들어:Exchange cmdlet reference topics use a standardized method that describes key aspects about the cmdlet. For example:

  • Cmdlet에서 사용할 수 있는 매개 변수입니다.Parameters that are available on the cmdlet.

  • 각 매개 변수를 허용 하는 값입니다.Values that each parameter accepts.

  • 함께 사용할 수 있는 매개 변수 및 개별적으로 사용할 필요가 있는 매개 변수입니다.Parameters that can be used together, and parameters that need to be used separately.

이 항목에서는 이러한 규칙과 ExchangePowerShell에서 명령을 실행하는 데 필요한 구문을 설명합니다.This topic explains these conventions, and also the syntax that's required to run commands in Exchange PowerShell.

Exchange PowerShell의 명령 규칙Command conventions in Exchange PowerShell

Exchange PowerShell 도움말은 필수 항목 또는 옵션 항목과, 명령을 실행할 때 매개 변수 및 값을 입력하는 방법을 나타내는 규칙을 따릅니다. 이러한 명령 규칙이 다음 표에 나와 있습니다.Exchange PowerShell help follows conventions that indicate what's required or optional, and how to enter parameters and values when you run a command. These command conventions are listed in the following table.

기호Symbol 설명Description
- 하이픈 매개 변수를 나타냅니다. 예, -Identity합니다.A hyphen indicates a parameter. For example, -Identity.
< > 꺾쇠 괄호에 대 한 매개 변수를 사용할 수 있는 값을 나타냅니다. 예, -Location <ServerName> 또는 '-사용 < $trueAngle brackets indicate the possible values for a parameter. For example, -Location <ServerName> or `-Enabled <$true
[ ] 대괄호 선택적 매개 변수 및 해당 값을 나타냅니다. 예, [-WhatIf <SwitchParameter>]합니다. 없는 대괄호로 매개 변수 값 쌍이 필요 합니다.Square brackets indicate optional parameters and their values. For example, [-WhatIf <SwitchParameter>]. Parameter-value pairs that aren't enclosed in square brackets are required.
| 매개 변수 값의 파이프 기호 표시 값 중 하나를 선택 합니다. 예,-활성화 된 <$true | $false> Enabled 매개 변수 값을 가질 수를 나타냅니다 $true 또는 $false합니다.Pipe symbols in parameter values indicate a choice between values. For example, -Enabled <$true | $false> indicates the Enabled parameter can have the value $true or $false.

이러한 명령 규칙은 명령 작성 방법을 이해하는 데 도움이 됩니다. Exchange PowerShell에서 cmdlet을 실행할 때 표에 설명된 대로 매개 변수를 나타내는 하이픈을 제외하고는 이러한 기호를 사용하지 마세요.These command conventions help you understand how a command is constructed. With the exception of the hyphen that indicates a parameter, you don't use these symbols as they're described in the table when you run cmdlets in Exchange PowerShell.

Exchange PowerShell의 매개 변수 집합Parameter sets in Exchange PowerShell

매개 변수 집합은 같은 명령에서 함께 사용할 수 있는 매개 변수 그룹입니다. 다른 매개 변수 집합에 있는 매개 변수는 같은 명령에 함께 사용할 수 없습니다.Parameter sets are groups of parameters that can be used with each other in the same command. Parameters that exist different parameter sets are mutually exclusive (they can't be used together in the same command).

많은 cmdlet에는 오직 하나의 매개 변수 집합만 있습니다. 즉, 사용 가능한 모든 매개 변수를 함께 사용할 수 있습니다. 다른 cmdlet에는 여러 개의 매개 변수 집합이 있습니다. 즉, 일부 매개 변수는 다른 매개 변수와 호환되지 않는 기능을 수행합니다. 예를 들어 다음 매개 변수 집합을 New-SystemMessage cmdlet에서 사용할 수 있다고 가정하겠습니다.Many cmdlets have only one parameter set, which means that all available parameters can be used with each other. Other cmdlets have several parameter sets, which indicates some parameters perform functions that are incompatible with other parameters. For example, suppose the following parameter sets are available on the New-SystemMessage cmdlet:

New-SystemMessage -DsnCode <EnhancedStatusCode> -Internal <$true | $false> -Language <CultureInfo> -Text <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]  <COMMON PARAMETERS>

New-SystemMessage -Language <CultureInfo> -QuotaMessageType <WarningMailboxUnlimitedSize | WarningPublicFolderUnlimitedSize | WarningMailbox | WarningPublicFolder | ProhibitSendMailbox | ProhibitPostPublicFolder | ProhibitSendReceiveMailBox> -Text <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]] <COMMON PARAMETERS>

이 cmdlet에는 두 가지 별도의 매개 변수 집합이 있습니다. 즉, 다음 매개 변수를 같은 명령에서 함께 사용할 수 있습니다.This cmdlet has two separate parameter sets. This indicates that you can use these parameters together in the same command:

  • DsnCodeDsnCode

  • InternalInternal

  • LanguageLanguage

  • TextText

  • ConfirmConfirm

  • 도메인 컨트롤러DomainController

  • WhatIfWhatIf

또한 다음 매개 변수도 같은 명령에서 함께 사용할 수 있습니다.And you can use these parameters together in the same command:

  • LanguageLanguage

  • QuotaMessageTypeQuotaMessageType

  • TextText

  • ConfirmConfirm

  • 도메인 컨트롤러DomainController

  • WhatIfWhatIf

하지만 다음 매개 변수는 같은 명령에서 함께 사용할 수 없습니다.But you can't use these parameters together in the same command:

  • DsnCodeQuotaMessageType.DsnCode and QuotaMessageType.

  • 내부QuotaMessageType_합니다._Internal and QuotaMessageType.

<COMMON PARAMETERS> 항목 cmdlet은 지원 (예: 디버그) 거의 모든 cmdlet에서 사용할 수 있는 기본적인 Windows PowerShell 매개 변수를 나타냅니다. 모든 매개 변수 집합에서 매개 변수를 가진 공통 매개 변수를 사용할 수 있습니다. 자세한 내용은 about_CommonParameters을 참조 하십시오.The <COMMON PARAMETERS> entry indicates the cmdlet supports the basic Windows PowerShell parameters that are available on virtually any cmdlet (for example, Debug). You can use common parameters with parameters from any parameter set. For more information, see about_CommonParameters.

Exchange PowerShell의 따옴표Quotation marks in Exchange PowerShell

Exchange PowerShel에서는 작은따옴표(') 또는 큰따옴표(")를 사용하여 공백이 포함된 매개 변수 값을 묶습니다. 예를 들어 다음 명령은 동일하게 작동합니다.In Exchange PowerShell, you use single quotation marks ( ' ) or double quotation marks ( " ) to enclose parameter values that contain spaces. For example, the following commands behave the same:

  • Get-ReceiveConnector -Identity "Contoso Receive Connector"

  • Get-ReceiveConnector -Identity 'Contoso Receive Connector'

값을 묶어야 하지 하는 경우 Contoso Receive Connector 따옴표로, Exchange PowerShell 새 인수로 각 단어를 처리 하 려 하 고 명령이 실패 합니다. 이 예제에서는 다음과 같은 오류가 표시 됨 표시 됩니다.If you don't enclose the value Contoso Receive Connector in quotes, Exchange PowerShell tries to treat each word as a new argument, and the command will fail. In this example, you'll receive an error that looks like this:

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

변수를 포함 하는 값을 하는 경우 작은따옴표로 사이의 큰따옴표로 신중 하 게 선택할 필요는 있습니다. 예를들어 라는 변수를가지고 $Server 값이 설치 된 Mailbox01합니다.If the value contains variables, you need choose carefully between single quotes and double quotes. For example, suppose you have a variable named $Server that has the value Mailbox01.

  • 큰따옴표: 변수 값으로 대체 됩니다. 출력에서 결과는 입력된 "$Server 예제" Mailbox01 Example합니다.Double quotation marks: Variables are substituted with their values. The input "$Server Example" results in the output Mailbox01 Example.

  • 작은따옴표 사용: 변수 문자 그대로 처리 됩니다. 출력에서 결과는 입력된 ' $Server 예제 ' $Server Example합니다.Single quotation marks: Variables are treated literally. The input '$Server Example' results in the output $Server Example.

변수에 대한 자세한 내용은 User-Defined VariablesShell Variables를 참조하십시오.For more information about variables, see User-Defined Variables and Shell Variables.

Exchange PowerShell의 이스케이프 문자Escape characters in Exchange PowerShell

모든 프로그래밍 언어에서 이스케이프 문자 특수 문자를 문자 그대로 아무일 식별 하는 데 사용 하 고 해당 언어로 정상적인 기능을 받지 합니다. Exchange PowerShell에서 큰따옴표, 텍스트 문자열을 묶어야 하는 경우 이스케이프 문자는 역방향 따옴표 이스케이프 문자 ( ` ).In any programming language, an escape character is used to identify special characters literally, and not by their normal function in that language. In Exchange PowerShell, when you enclose a text string in double quotation marks, the escape character is the back quotation mark escape character ( ` ).

예: 출력 하려는 경우 The price is $23, 값을 입력 "가격이 `$23" 합니다. 이스케이프 문자는 달러 기호 ($) Exchange PowerShell에서 변수를 정의 하기 때문에 필요 합니다.For example, if you want the output The price is $23, enter the value "The price is `$23". The escape character is required because the dollar sign character ( $ ) defines variables in Exchange PowerShell.

작은따옴표로 문자열을 묶어야 하는 경우 염려할 필요가 특수 문자는 두 단일 큰따옴표 (")를 사용 해야하는 작은따옴표 문자 자체를 합니다.If you enclose the string in single quotation marks, the only special character you need to worry about is the single quotation mark character itself, which requires two single quotation marks ( '' ).

예: 출력 하려는 경우 Don't confuse two single quotation marks with a double quotation mark!, 값을 입력 ' Don ' t 혼동 큰따옴표와 작은따옴표 두!' 합니다.For example, if you want the output Don't confuse two single quotation marks with a double quotation mark!, enter the value 'Don''t confuse two single quotation marks with a double quotation mark!'.

Exchange PowerShell의 명령 연산자Command operators in Exchange PowerShell

다음 표는 Exchange 명령에 사용할 수 있는 올바른 연산자를 보여줍니다. 이러한 기호 중 일부는 이전의 Exchange PowerShell의 명령 규칙 섹션에서 설명했습니다. 그러나 이러한 기호는 명령줄에서 연산자로 사용될 경우 다른 의미를 갖습니다. 예를 들면 매개 변수를 나타내는 데 사용되는 빼기 기호는 명령에 수학 연산자로 사용될 수도 있습니다.The following table shows the valid operators that you can use in an Exchange command. Some of these symbols were also described in the earlier Command conventions in Exchange PowerShell section. However, these symbols have different meanings when they're used on the command line as operators. For example, the minus sign that's used to indicate a parameter can also be used in a command as a mathematical operator.

연산자Operator 설명Description
= 등호는 대입 문자로 사용됩니다. 등호 오른쪽의 값은 등호 왼쪽의 변수에 대입됩니다. 다음 문자도 대입 문자입니다.The equal sign is used as an assignment character. The value on the right side of the equal sign is assigned to the variable on the left side of the equal sign. The following characters are also assignment characters:
+=: 등호의 왼쪽된 가장자리에서 변수에 포함 된 현재 값을 등호의 오른쪽에 값을 추가 합니다.+=: Add the value on the right side of the equal sign to the current value that's contained in the variable on the left side of the equal sign.
-=: 등호의 왼쪽된 가장자리에서 변수에 포함 된 현재 값에서 등호의 오른쪽에 있는 값을 뺍니다.-=: Subtract the value on the right side of the equal sign from the current value that's contained in the variable on the left side of the equal sign.
• ** * **: 등호의 오른쪽에 지정 된 값으로 변수 등호의 왼쪽된 가장자리에서의 현재 값을 곱합니다.*=: Multiply the current value of the variable on the left side of the equal sign by the value that's specified on the right side of the equal sign.
/=: 등호의 오른쪽에 지정 된 값으로 변수 등호의 왼쪽된 가장자리에서의 현재 값을 나눕니다./=: Divide the current value of the variable on the left side of the equal sign by the value that's specified on the right side of the equal sign.
%=: 등호의 오른쪽에 지정 된 값으로 변수 등호의 왼쪽된 가장자리에서의 현재 값을 수정 합니다.%=: Modify the current value of the variable on the left side of the equal sign by the value that's specified on the right side of the equal sign.
: 콜론 매개 변수의 이름을 매개 변수의 값에서 분리를 사용할 수 있습니다. 예, -Enabled:$True합니다. 콜론을 사용 하 여 스위치 매개 변수를 제외한 모든 매개 변수 형식을 가진 선택 사항입니다. 스위치 매개 변수에 대 한 자세한 내용은 Parameters를 참고 하십시오.A colon can be used to separate a parameter's name from the parameter's value. For example, -Enabled:$True. Using a colon is optional with all parameter types except switch parameters. For more information about switch parameters, see Parameters.
! 느낌표는 논리적 NOT 연산자입니다. 등호( = ) 기호와 함께 사용하는 경우 조합된 쌍은 "같지 않음"을 의미합니다. The exclamation point is a logical NOT operator. When it is used with the equal ( = ) sign, the combined pair means "not equal to."
[ ] 대괄호는 배열 위치의 인덱스 값을 지정 하는데 사용 됩니다. 인덱스 값은 오프셋은 0부터 시작 하는 합니다. 예, $Red[9] 참조 하는 배열에서 10 번째 인덱스 위치를 $Red합니다.Brackets are used to specify the index value of an array position. Index values are offsets that start at zero. For example, $Red[9] refers to the tenth index position in the array, $Red.
대괄호를 사용 하 여 형식의 변수를 할당할 수도 있습니다 (예를들어, $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.Brackets can also be used to assign a type to a variable (for example, $A=[XML] "<Test><A>value</A></Test>"). The following variable types are available: Array, Bool, Byte, Char, Char[], Decimal, Double, Float, Int, Int[], Long, Long[], RegEx, Single, ScriptBlock, String, Type, and XML.
{ } 중괄호를 명령에는 식을 포함 하는 데 사용 됩니다. 예, Get-프로세스 | 여기에서 {$_합니다. 400 HandleCount-gt}Braces are used to include an expression in a command. For example, Get-Process | Where {$_.HandleCount -gt 400}
| 파이프 기호는 하나의 cmdlet 결과 다른 cmdlet에 파이프 하는 경우에 사용 됩니다. 예: Get-사서함-서버 s r v 1 | Set-mailbox-ProhibitSendQuota 2GB 합니다.The pipe symbol is used when one cmdlet pipes a result to another cmdlet. For example, Get-Mailbox -Server SRV1 | Set-Mailbox -ProhibitSendQuota 2GB.
> 파일의 내용을 덮어씁니다 및 오른쪽 꺾쇠 괄호는 명령의 출력 파일을 보내도록 사용 됩니다. 예, Get-TransportRulePredicate > "C:\My Documents\Output.txt"합니다.The right-angle bracket is used to send the output of a command to a file, and the contents of the file are overwritten. For example, Get-TransportRulePredicate > "C:\My Documents\Output.txt".
>> 이중 닫는 꺾쇠 괄호 기존 파일에는 명령의 출력을 추가 하는 데 사용 됩니다. 파일이 존재 하지 않는 경우에 새 파일이 만들어집니다. 예, Get-TransportRulePredicate >> "C:\My Documents\Output.txt"합니다.Double right-angle brackets are used to append the output of a command to an existing file. If the file doesn't exist, a new file is created. For example, Get-TransportRulePredicate >> "C:\My Documents\Output.txt".
" 큰따옴표는 공백을 포함한 텍스트 문자열을 묶는 데 사용됩니다.Double quotation marks are used to enclose text strings that contains spaces.
$ 달러 기호 변수를 나타냅니다. 예, $Blue = 10 값을 할당 10 변수에 $Blue합니다.A dollar sign indicates a variable. For example, $Blue = 10 assigns the value 10 to the variable $Blue.
@ @ 기호는 결합형 배열을 참조합니다. 자세한 내용은 Arrays를 참조하십시오.The @ symbol references an associative array. For more information, see Arrays.
$( )$( ) 달러 기호 ( $ )에 괄호가 있는 명령 대체를 나타냅니다. 다른 명령에 대 한 인수로 한 명령의 출력을 사용 하려는 경우 명령은 대체를 사용할 수 있습니다. 예, Get-ChildItem $(Read-Host -Prompt "Enter FileName: ")합니다.A dollar sign ( $ ) with parentheses indicates command substitution. You can use command substitution when you want to use the output of one command as an argument in another command. For example, Get-ChildItem $(Read-Host -Prompt "Enter FileName: ").
.. 이중 기간 값 범위를 나타냅니다. 등 여러 인덱스를 포함 하는 배열, 하는 경우 수 값을 반환 하면 모든 인덱스의 명령을 실행 하 여 두번째 및 다섯번째 인덱스 간의: $Blue[2..5]합니다.Double-periods indicate a value range. For example, if an array contains several indexes, you can return the values of all indexes between the second and fifth indexes by running the command: $Blue[2..5].
+ + 연산자 두 값을 함께 추가 합니다. 예, 6 + 6 equals 12합니다.The + operator adds two values together. For example, 6 + 6 equals 12.
- - 연산자 다른 값에서 하나의 값을 뺍니다 (등 12 - 6 equals 6) 또는 음수를 나타냅니다 (등 -6 * 6 equals -36).The - operator subtracts one value from another value (for example, 12 - 6 equals 6) or indicates a negative number (for example, -6 * 6 equals -36).
\* 문자열에 맞게 와일드 카드 문자를 사용할 수 있습니다 (예: Get-사용자 | Where-object {$_합니다. 부서-like ' Sales *'}), 숫자 값을 곱합니다 (등 6 * 6 equals 36), 문자열 값 지정한 횟수 만큼 반복 또는 (등 "Test" * 3 equals TestTestTest).You can use the wildcard character to match strings (for example, Get-User | Where-Object {$_.Department -like 'Sales*'}), multiply numeric values (for example, 6 * 6 equals 36), or repeat the string value the specified number of times (for example, "Test" * 3 equals TestTestTest).
/ / 연산자는 하나의 값을 다른 값으로 나눕니다. 예를 들면 6 / 61과 같습니다. The / operator divides one value by another. For example, 6 / 6 equals 1.
% 숫자 평가에서 % 연산자는 나누기 연산의 나머지를 반환합니다. 예를 들면 6 % 42과 같습니다. In a numerical evaluation, the % operator returns the remainder from a division operator. For example, 6 % 4 equals 2.
백분율 문자는 파이프라인의 ( % ) 축약 한 Foreach-object cmdlet에 대 한 것입니다. 예, Import-csv c:\MyFile.csv | ForEach 개체 {Set-mailbox $_합니다. Identity-$ 라는 이름을_합니다. 이름}은 Import-csv c:\MyFile.csv | % {Set-mailbox $_합니다. Identity-$ 라는 이름을_합니다. 이름}입니다. 자세한 내용은 Pipelining을 참조 하십시오.In a pipeline, the percent character ( % ) is shorthand for the ForEach-Object cmdlet. For example, Import-Csv c:\MyFile.csv | ForEach-Object {Set-Mailbox $_.Identity -Name $_.Name} is the same as Import-Csv c:\MyFile.csv | % {Set-Mailbox $_.Identity -Name $_.Name}. For more information, see Pipelining.
? 물음표 문자 ( ? )은 Where-object cmdlet에 대 한 대표 속성입니다. 예, Get-alias | Where-object {$_합니다. 정의-eq "암호화 되지 않은 호스트"}은 Get-alias | ? {$_. 정의-eq "암호화 되지 않은 호스트"}The question mark character ( ? ) is shorthand for the Where-Object cmdlet. For example, Get-Alias | Where-Object {$_.Definition -eq "Clear-Host"} is the same as Get-Alias | ? {$_.Definition -eq "Clear-Host"}