Get-ExchangeSettings
이 cmdlet은 온-프레미스 Exchange에서만 제공됩니다.
Get-ExchangeSettings cmdlet을 사용하여 Active Directory에 저장된 사용자 지정된 Exchange 설정 개체를 볼 수 있습니다. New-ExchangeSettings 사용하여 설정 개체를 만들고 Set-ExchangeSettings cmdlet을 사용하여 실제 설정을 정의합니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Get-ExchangeSettings
[[-Identity] <ExchangeSettingsIdParameter>]
[-ConfigName <String>]
[-Database <DatabaseIdParameter>]
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[-Force]
[-GenericScopeName <String>]
[-GenericScopes <String[]>]
[-GenericScopeValue <String>]
[-Organization <OrganizationIdParameter>]
[-Process <String>]
[-Server <ServerIdParameter>]
[-User <Guid>]
[<CommonParameters>]
Description
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 문서에서는 cmdlet에 대한 모든 매개 변수를 나열하지만 할당된 권한에 포함되지 않은 경우 일부 매개 변수에 액세스할 수 없을 수 있습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Get-ExchangeSettings
다음은 모든 Exchange 설정 개체의 요약 목록을 반환하는 예제입니다.
예 2
Get-ExchangeSettings -Identity Audit | Format-List
다음은 모든 Exchange 설정 개체의 요약 목록을 반환하는 예제입니다.
매개 변수
-ConfigName
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
ConfigName 매개 변수는 지정된 속성 이름으로 결과를 필터링합니다. 지정한 값은 EffectiveSetting 속성에 표시됩니다.
사용 가능한 값은 Exchange 설정 개체의 스키마에 의해 결정됩니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Database
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Database 매개 변수는 결과를 사서함 데이터베이스별로 필터링합니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.
- 이름
- DN(고유 이름)
- ExchangeLegacyDN
- GUID
매개 변수 속성
| 형식: | DatabaseIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Diagnostic
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Diagnostic 스위치는 결과에 매우 자세한 정보를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
자세한 정보는 DiagnosticInfo 속성에 표시됩니다.
일반적으로 이 스위치는 Microsoft 고객 서비스 및 지원 요청 시에만 사용하여 문제를 해결합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-DiagnosticArgument
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
DiagnosticArgument 매개 변수는 Diagnostic 스위치를 사용하여 반환되는 결과를 수정합니다. 일반적으로 Diagnostic 스위치와 DiagnosticArgument 매개 변수는 Microsoft 고객 서비스 및 지원 요청 시에만 사용하여 문제를 해결합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-DomainController
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com
매개 변수 속성
| 형식: | Fqdn |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Force
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
강제 스위치는 경고 또는 확인 메시지를 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
관리 입력에 대한 확인 메시지를 표시하는 것이 부적절한 경우 이 스위치를 사용하여 작업을 프로그래밍 방식으로 실행할 수 있습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-GenericScopeName
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
GenericScopeName 매개 변수는 결과를 scope 기준으로 필터링합니다. 사용 가능한 값은 Exchange 설정 개체의 스키마에 의해 결정됩니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-GenericScopes
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
GenericScopes 매개 변수는 결과를 scope 기준으로 필터링합니다. 사용 가능한 값은 Exchange 설정 개체의 스키마에 의해 결정됩니다. 이 매개 변수는 "key1=value1","key2=value2", "keyN=valueN 구문을 사용합니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-GenericScopeValue
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
GenericScopeValue 매개 변수는 GenericScopeName 매개 변수에 지정된 scope 값으로 결과를 필터링합니다. 사용 가능한 값은 Exchange 설정 개체의 스키마에 의해 결정됩니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Identity 매개 변수는 Exchange 설정 개체의 이름을 지정합니다. 개체를 고유하게 식별하는 어떤 값도 사용 가능합니다. 예:
- 이름
- DN(고유 이름)
- GUID
주의: identity 매개 변수의 값 $null 또는 존재하지 않는 값은 Identity 매개 변수 없이 Get- 명령을 실행한 것처럼 모든 개체를 반환합니다. Identity 매개 변수에 대한 값 목록이 정확하고 존재하지 않는 $null 값이 포함되어 있지 않은지 확인합니다.
매개 변수 속성
| 형식: | ExchangeSettingsIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Organization
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
매개 변수 속성
| 형식: | OrganizationIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Process
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Process 매개 변수는 지정된 프로세스로 결과를 필터링합니다. 사용 가능한 값은 Exchange 설정 개체의 스키마에 의해 결정됩니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Server
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Server 매개 변수는 Exchange 서버별로 결과를 필터링합니다. 서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예제:
- 이름
- DN(고유 이름)
- ExchangeLegacyDN
- GUID
매개 변수 속성
| 형식: | ServerIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-User
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
User 매개 변수는 사용자별로 결과를 필터링합니다. GUID 값으로 사용자를 식별합니다(예: 87246450-1b19-4c81-93dc-1a4200eff66c). 사용자의 GUID를 찾으려면 명령을 Get-User <UserIdentity> | Format-List Name,GUID실행합니다.
매개 변수 속성
| 형식: | Guid |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.