Exchange cmdlet 구문

아티클
09/07/2023

Exchange cmdlet 참조 문서에서는 cmdlet에 대한 주요 측면을 설명하는 표준화된 메서드를 사용합니다. 예를 들면

cmdlet에서 사용할 수 있는 매개 변수입니다.
각 매개 변수가 허용하는 값입니다.
함께 사용할 수 있는 매개 변수 및 별도로 사용해야 하는 매개 변수입니다.

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

Exchange PowerShell의 명령 규칙

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

기호	설명
`-`	하이픈은 매개 변수를 나타냅니다. 예를 들면 `-Identity`와 같습니다.
`< >`	꺾쇠 괄호는 매개 변수에 사용 가능한 값을 나타냅니다. 예를 들어 `-Location <ServerName>` 또는 -Enabled <$true \| $false>.
`[ ]`	대괄호는 선택적 매개 변수와 해당 값을 나타냅니다. 예를 들어 `[-WhatIf]` 또는 `[-ResultSize <Unlimited>]`입니다. 대괄호로 묶이지 않은 매개 변수-값 쌍이 필요합니다. 예를 들면 `-Password <SecureString>`와 같습니다. 매개 변수 이름 자체의 대괄호는 위치 매개 변수를 나타내며(매개 변수 이름을 지정하지 않고 매개 변수 값을 사용할 수 있음) 위치 매개 변수가 필요하거나 선택적일 수 있습니다. 예를 들어 `Get-Mailbox [[-Identity] <MailboxIdParameter>]`Identity 매개 변수는 위치(대괄호로 묶이기 때문에) 및 선택 사항(전체 매개 변수-값 쌍이 대괄호로 묶이기 때문에)이므로 또는 `Get-Mailbox <MailboxIdParameter>`를 사용할 `Get-Mailbox -Identity <MailboxIdParameter>` 수 있습니다. 마찬가지로, `Set-Mailbox [-Identity] <MailboxIdParameter>`Identity 매개 변수는 위치(대괄호로 묶이기 때문에)이고 필수(전체 매개 변수-값 쌍이 대괄호로 묶이지 않기 때문에)를 사용하므로 또는 `Set-Mailbox <MailboxIdParameter>`를 사용할 `Set-Mailbox -Identity <MailboxIdParameter>` 수 있습니다.
`\|`	매개 변수 값에서 파이프 기호는 값 사이의 선택 항목을 나타냅니다. 예를 들어 -Enabled <$true \| $false>Enabled 매개 변수에 또는 값 `$true$false`이 있을 수 있음을 나타냅니다.

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

Exchange PowerShell의 매개 변수 집합

매개 변수 집합은 같은 명령에서 함께 사용할 수 있는 매개 변수 그룹입니다. 각 매개 변수 집합에는 다른 매개 변수 집합에서 사용할 수 없는 매개 변수가 하나 이상 포함되어 있지만 매개 변수 집합은 일반적으로 일부 parameters.s를 공유합니다.

많은 cmdlet에는 하나의 매개 변수 집합만 있습니다. 즉, 모든 매개 변수를 서로 사용할 수 있습니다. 다른 cmdlet에는 여러 매개 변수 집합이 있습니다. 즉, 일부 매개 변수를 다른 매개 변수와 함께 사용할 수 없습니다. 예를 들어 New-SystemMessage cmdlet에서 다음 매개 변수 집합을 사용할 수 있다고 가정합니다.

New-SystemMessage -DsnCode <EnhancedStatusCode> -Internal <Boolean> -Language <CultureInfo> -Text <String> [-Confirm] [-DomainController <Fqdn>] [-WhatIf] <CommonParameters>

New-SystemMessage -QuotaMessageType <QuotaMessageType> -Language <CultureInfo> -Text <String> [-Confirm] [-DomainController <Fqdn>] [-WhatIf] <CommonParameters>

다음 매개 변수는 첫 번째 매개 변수 집합에서 사용할 수 있으므로 동일한 명령에서 사용할 수 있습니다.

DsnCode
내부
언어
텍스트
확인
DomainController
Whatif

다음 매개 변수는 두 번째 매개 변수 집합에서 사용할 수 있으므로 동일한 명령에서 사용할 수 있습니다.

QuotaMessageType
언어
텍스트
확인
DomainController
Whatif

DsnCode 및 Internal 매개 변수는 첫 번째 매개 변수 집합에서만 사용할 수 있습니다. QuotaMessageType 매개 변수는 두 번째 매개 변수 집합에서만 사용할 수 있습니다. 따라서 동일한 명령에서 다음 매개 변수를 사용할 수 없습니다.

DsnCode 및 QuotaMessageType.
Internal 및 QuotaMessageType.

다음 매개 변수는 두 매개 변수 집합에서 모두 사용할 수 있으므로 New-SystemMessage 명령에서 사용할 수 있습니다.

언어
텍스트
확인
DomainController
Whatif

항목은 <CommonParameters> cmdlet이 거의 모든 cmdlet(예: 자세한 정보 표시)에서 사용할 수 있는 기본 Windows PowerShell 매개 변수를 지원한다는 것을 나타냅니다. 모든 매개 변수 집합의 매개 변수와 함께 공통 매개 변수를 사용할 수 있습니다. 자세한 내용은 about_CommonParameters를 참조하세요.

Exchange PowerShell의 따옴표

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

Get-ReceiveConnector -Identity "Contoso Receive Connector"
Get-ReceiveConnector -Identity 'Contoso Receive Connector'

이전 예제에서 값을 작은따옴표나 큰따옴표로 묶지 않으면 PowerShell이 각 단어를 새 인수로 처리하기 때문에 명령이 실패합니다(Identity 매개 변수의 값이며 Receive 지정되지 않은 위치 매개 변수의 값이라고 생각 Contoso 함). 이 예제에서 오류는 다음과 같습니다.

'Receive' 인수를 허용하는 위치 매개 변수를 찾을 수 없습니다.

일반 텍스트 값의 경우 작은따옴표와 큰따옴표는 중요하지 않습니다. 그러나 변수가 관련될 때 선택은 중요합니다.

큰따옴표: 변수는 실제 값으로 대체됩니다.
작은따옴표: 변수는 문자 그대로 처리됩니다.

예를 들어 사용하는 $Server = Mailbox01 따옴표에 따라 다음 출력이 생성됩니다.

"$Server 예제" 는 을 반환합니다 Mailbox01 Example.
'$Server 예제' 는 을 반환합니다 $Server Example.

변수에 대한 자세한 내용은 about_Variables 및 about_Automatic_Variables 참조하세요.

Exchange PowerShell의 이스케이프 문자

모든 프로그래밍 언어에서 이스케이프 문자 는 해당 언어의 정규 함수가 아니라 문자 그대로 특수 문자를 식별하는 데 사용됩니다. Exchange PowerShell에서 텍스트 문자열을 큰따옴표로 묶으면 이스케이프 문자는 따옴표 이스케이프 문자( ' )입니다.

예를 들어 출력 The price is $23을 원하는 경우 "가격은 '$23'입니다" 값을 입력합니다. $는 PowerShell에서 변수를 정의하기 때문에 달러 기호 문자($ )에 이스케이프 문자가 필요합니다.

문자열을 작은따옴표로 묶는 경우 걱정할 필요가 있는 유일한 특수 문자는 작은따옴표 문자 자체이며 이스케이프하려면 두 개의 작은따옴표가 필요합니다( '' ).

예를 들어 출력 Don't confuse two single quotation marks with a double quotation mark!을 원하는 경우 '작은따옴표 두 개와 큰따옴표를 혼동하지 마세요!'값을 입력합니다.

Exchange PowerShell의 명령 연산자

다음 표는 Exchange 명령에 사용할 수 있는 올바른 연산자를 보여줍니다. 이러한 기호 중 일부는 이전의 Exchange PowerShell의 명령 규칙 섹션에서 설명했습니다. 그러나 이러한 기호는 명령줄에서 연산자로 사용될 경우 다른 의미를 갖습니다. 예를 들면 매개 변수를 나타내는 데 사용되는 빼기 기호는 명령에 수학 연산자로 사용될 수도 있습니다.

연산자	설명
`=`	등호는 할당 문자입니다. 등호의 오른쪽에 있는 값은 등호의 왼쪽에 있는 변수에 할당됩니다(예: `$x= Get-Mailbox`). 등호와 함께 다른 문자를 사용할 수도 있습니다. `+=`: 등호의 오른쪽에 있는 값을 등호 왼쪽의 변수에 포함된 현재 값에 추가합니다. `-=`: 등호의 왼쪽에 있는 변수에 포함된 현재 값에서 등호 오른쪽의 값을 뺍니다. `*=`: 등호 왼쪽에 있는 변수의 현재 값을 등호의 오른쪽에 지정된 값으로 곱합니다. `/=`: 등호 왼쪽에 있는 변수의 현재 값을 등호의 오른쪽에 지정된 값으로 나눕니다. `%=`: 등호의 오른쪽에 지정된 값으로 등호 왼쪽에 있는 변수의 현재 값을 수정합니다.
`:`	콜론을 사용하여 매개 변수의 이름을 매개 변수 값과 구분합니다. 예를 들면 `-Enabled:$True`와 같습니다. 콜론 구분 기호는 작동하며 거의 모든 매개 변수-값 쌍에서 선택 사항입니다. 스위치 매개 변수에는 콜론 구분 기호가 필요합니다. 스위치 매개 변수에 대한 자세한 내용은 about_Parameters 참조하세요.
`!`	느낌표는 논리 NOT 연산자입니다. 결합된 쌍 `!=` 은 "같지 않음"을 의미합니다.
`[ ]`	대괄호는 배열 위치의 인덱스 값을 지정합니다. 인덱스 값은 항상 0에서 시작하는 오프셋입니다. 예를 들어 라는 `$Red`배열에서 배열의 10번째 위치 값은 입니다 `$Red[9]`. 대괄호는 변수에 형식을 할당할 수도 있습니다. 예를 들어 라는 `$A` 변수를 XML로 식별하려면 를 사용합니다 `$A=[XML] "<Test><A>value</A></Test>"`. 사용할 수 `Array`있는 변수 형식은 , , `Bool`, `Byte`, `CharChar[]`, `Decimal`, `Double`, `FloatInt`, `Int[]`, `Long`, , `SingleTypeLong[]RegExScriptBlockString`, 및 입니다.`XML.`
`{ }`	중괄호를 사용하여 명령에 식을 포함합니다. 예를 들면 `Get-Process \| Where {$_.HandleCount -gt 400}`
`\|`	파이프 기호를 사용하여 한 명령의 출력을 다른 명령으로 파이프합니다. 예를 들면 `Get-Mailbox -Server SRV1 \| Set-Mailbox -ProhibitSendQuota 2GB`와 같습니다.
`>`	오른쪽 꺾쇠 괄호를 사용하여 명령의 출력을 파일로 보냅니다. 파일이 이미 있는 경우 내용을 덮어씁니다. 예를 들면 `Get-TransportRule > "C:\My Documents\TransportRules.txt"`와 같습니다.
`>>`	이중 오른쪽 꺾쇠 괄호를 사용하여 명령의 출력을 기존 파일에 추가합니다. 파일이 없으면 새 파일이 만들어집니다. 예를 들면 `Get-TransportRule >> "C:\My Documents\TransportRules.txt"`와 같습니다.
`"`	큰따옴표를 사용하여 공백이 포함된 텍스트 문자열을 묶습니다. 앞에서 설명한 대로 변수는 실제 값으로 대체됩니다.
`$`	달러 기호는 변수를 나타냅니다. 예를 들어 값이 10인 라는 `$Blue` 변수를 만들려면 를 사용합니다 `$Blue = 10`. 변수를 저장한 후 매개 변수 값으로 사용할 수 있습니다.
`@`	at 기호는 연관 배열을 참조합니다. 자세한 내용은 about_Arrays 참조하세요.
`$( )`	괄호가 있는 달러 기호는 명령 대체를 나타냅니다. 한 명령의 출력을 다른 명령의 인수로 사용하려는 경우 명령 대체를 사용할 수 있습니다. 예를 들면 `Get-ChildItem $(Read-Host -Prompt "Enter FileName: ")`와 같습니다.
`..`	이중 기간은 값 범위를 나타냅니다. 예를 들어 배열에 여러 인덱스가 포함된 경우 명령을 `$Blue[2..5]`실행하여 두 번째 인덱스와 다섯 번째 인덱스 사이의 모든 인덱스 값을 반환할 수 있습니다.
`+`	더하기 기호 연산자는 두 값을 함께 추가합니다. 예를 들면 `6 + 6`은 `12`과 같습니다.
`-`	빼기 기호 연산자는 다른 값에서 한 값을 빼거나(예 `12 - 6` : 같 `6`음) 음수를 나타냅니다(예 `-6 * 6` : 등) `-36`.
`*`	별표로 다음을 수행할 수 있습니다. 문자열 일치: 예를 들어 `Get-User \| Where-Object {$_.Department -like 'Sales'})` 숫자 값 곱하기: 예를 들어 `6 6` 같음 `36` 문자열 값을 지정된 횟수만큼 반복합니다. 예를 들어 `"Test" * 3` 같음 `TestTestTest`
`/`	슬래시는 한 값을 다른 값으로 나눕니다. 예를 들면 `6 / 6`은 `1`과 같습니다.
`%`	백분율 기호에는 다음과 같은 용도가 있습니다. 숫자 계산에서는 나누기 연산자에서 나머지를 반환합니다. 예를 들면 `6 % 4`은 `2`과 같습니다. 파이프라인에서는 ForEach-Object cmdlet의 약어입니다. 예를 들면 `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}`과 같습니다.
`?`	물음표 문자는 Where-Object cmdlet의 약어입니다. 예를 들면 `Get-Alias \| Where-Object {$_.Definition -eq "Clear-Host"}` is the same as `Get-Alias \| ? {$_.Definition -eq "Clear-Host"}`과 같습니다.

다음을 통해 공유