매개 변수
적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007
마지막으로 수정된 항목: 2007-06-20
대부분의 cmdlet는 매개 변수에 의존합니다. 매개 변수는 cmdlet에 정보를 제공하는 요소로, 적용할 개체 및 해당 특성을 식별하거나 cmdlet가 해당 작업을 수행하는 방식을 제어합니다. 다음과 같이 매개 변수 이름 앞에 하이픈(-)이 있고 그 다음에 매개 변수 값이 옵니다.
Verb-Noun -ParameterName <ParameterValue>
이 예에서 매개 변수 이름 앞에 있는 하이픈은 Exchange 관리 셸에 하이픈 바로 다음에 오는 단어가 cmdlet에 전달되는 매개 변수이고 매개 변수 다음에 오는 별도의 단어가 매개 변수 값임을 알려 줍니다.
위치 매개 변수
위치 매개 변수는 매개 변수 이름을 지정하지 않고 매개 변수 값을 지정할 수 있는 매개 변수입니다. Parameter Position 특성이 정수이면 그 매개 변수는 위치 매개 변수입니다. 이 정수는 cmdlet가 매개 변수 값을 찾을 수 있는 명령줄의 위치를 나타냅니다.
대부분의 cmdlet에는 위치 매개 변수 Identity가 하나만 있습니다. Identity는 cmdlet에서 사용할 수 있으면 항상 위치 1에 있습니다. 매개 변수가 위치 매개 변수가 아니면 named 매개 변수로 간주됩니다. named 매개 변수에 대한 매개 변수 이름과 값을 지정해야 합니다.
다음 두 명령은 "Contoso"라는 수신 커넥터에 대한 구성 정보를 반환하는 동일한 작업을 수행합니다.
Get-ReceiveConnector -Identity "Contoso"
Get-ReceiveConnector "Contoso"
매개 변수 정보
각 매개 변수에 대한 정보는 메타데이터라고도 하며 Get-Help cmdlet에서 검색한 정보의 매개 변수 섹션에 포함되어 있습니다. 다음은 Get-Service cmdlet의 예입니다.
PARAMETERS
-ServiceName System.String[]
Parameter required? false
Parameter position? 1
Default value *
Accept pipeline input? true
Accept wildcard characters? True
이 예는 Get-Service cmdlet에 포함되어 있는데, ServiceName 매개 변수에 대해 전달할 수 있는 값 형식에 대한 몇 가지 특정 정보를 포함하고 있습니다. 일부 cmdlet에만 그러한 정보가 포함되어 있습니다. 그러나 대부분의 cmdlet에는 표 1에 설명된 대로 각 매개 변수에 대한 몇 가지 설정이 포함되어 있습니다.
표 1 매개 변수 설정
| 설정 | 설명 |
|---|---|
Required? |
이 설정은 매개 변수를 제공하지 않을 경우 cmdlet 실행 여부를 나타냅니다. Required?를 |
Position? |
이 설정은 매개 변수 값 앞에 매개 변수 이름을 지정해야 하는지 여부를 나타냅니다. Position?을 Position?을 정수로 설정한 경우에는 이름은 지정하지 않아도 되며 값만 지정하면 됩니다. |
Default value |
이 설정은 다른 값을 제공하지 않으면 이 매개 변수에 대한 기본값을 나타냅니다. |
Accept pipeline input? |
이 설정은 매개 변수가 해당 값을 다른 cmdlet의 파이프라인을 통한 입력으로 받을 수 있는지 여부를 나타냅니다. |
Accept wildcard characters? |
이 설정은 매개 변수 값에 와일드카드 문자를 사용할 수 있는지 여부와 매개 변수 값을 여러 개체에 일치시킬 수 있는지 여부를 나타냅니다. |
부울 매개 변수
부울 매개 변수는 Exchange 관리 셸에서 기능이나 옵션이 사용하도록 설정되었는지($True), 사용하지 않도록 설정되었는지($False)를 결정하는 데 사용됩니다. 부울 매개 변수에 지정한 값은 수정할 개체의 구성에 저장됩니다. 부울 매개 변수에 값을 제공하는 경우에는 값 $True 또는 1이나 $False 또는 0을 사용해야 합니다. $True 및 $False에 달러 기호($)가 포함되어야 합니다. 일부 명령이 부울 매개 변수 이름과 부울 값 사이에 콜론(:)을 삽입할 수 있습니다. 부울 매개 변수에서 이 콜론은 선택 사항입니다. 다음 예에서는 수신 커넥터 "Contoso.com"을 사용하지 않도록 설정합니다.
Set-ReceiveConnector "Contoso.com" -Enabled $False
스위치 매개 변수
스위치 매개 변수는 Exchange 관리 셸에서 명령의 즉시 실행 상태를 설정하는 데 사용됩니다. 이 상태는 명령 사이에 저장되지 않습니다. 스위치 매개 변수는 부울 매개 변수와 비슷하지만 다른 용도로 사용되며 다른 구문을 사용해야 합니다. 스위치 매개 변수는 값이 필요하지 않습니다. 기본적으로 명령줄에 스위치 매개 변수만 지정하고 값을 지정하지 않으면 매개 변수는 $True로 평가됩니다. 스위치 매개 변수에는 부울 매개 변수와 마찬가지로 $True 또는 1이나 $False 또는 0만 사용할 수 있습니다. $True 및 $False에 달러 기호($)가 포함되어야 합니다. 부울 매개 변수와 달리 스위치 매개 변수 이름과 스위치 값 사이에 콜론(:)을 사용해야 합니다. 아래의 첫 번째 예에서는 Exchange 관리 셸에 EdgeSync 동기화를 시작하기 전에 확인 메시지를 표시하도록 지시합니다. 두 번째 예에서는 Exchange 관리 셸에 확인 메시지를 표시하지 않고 수신 커넥터 "Contoso.com"을 삭제하도록 지시합니다.
Start-EdgeSynchronization -Confirm
Remove-ReceiveConnector "Contoso.com" -Confirm:$False
일반 매개 변수
일반 매개 변수는 Exchange 관리 셸에 의해 모든 명령에 자동으로 추가되는 매개 변수입니다. 이러한 매개 변수는 실행될 명령과 함께 또는 그러한 명령에서 사용할 수 있는 기능을 수행합니다. 표 2에는 Exchange 관리 셸에서 사용할 수 있는 일반 명령 목록이 나와 있습니다. WhatIf, Confirm 및 ValidateOnly 매개 변수도 cmdlet에 추가할 수 있습니다. 이러한 추가 매개 변수에 대한 자세한 내용은 WhatIf, Confirm 및 ValidateOnly 매개 변수를 참조하십시오.
표 2 Exchange 관리 셸의 일반 매개 변수
| 매개 변수 이름 | 필수 | 유형 | 설명 |
|---|---|---|---|
Verbose |
선택 |
System.Boolean |
이 매개 변수는 명령에 작업에 대한 세부 정보를 제공하도록 지시합니다. |
Debug |
선택 |
System.Boolean |
이 매개 변수는 명령에 작업에 대한 프로그래머 수준의 정보를 제공하도록 지시합니다. |
ErrorAction |
선택 |
System.Enum |
이 매개 변수는 오류 발생 시 명령의 동작을 제어합니다. 값은 다음과 같습니다.
|
ErrorVariable |
선택 |
System.String |
이 매개 변수는 처리 중에 발생한 오류를 저장할 때 명령에 사용되는 변수의 이름을 지정합니다. 이 변수는 |
OutVariable |
선택 |
System.String |
이 매개 변수는 명령이 이 명령에서 출력된 개체에 사용하는 변수의 이름을 지정합니다. 이것은 명령을 |