Set-ExchangeSettings

구문

ClearHistory

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-ClearHistory]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

UpdateSetting

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ConfigName <String>
    -ConfigValue <String>
    -Reason <String>
    [-UpdateSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-WhatIf]
    [<CommonParameters>]

RemoveSetting

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ConfigName <String>
    -Reason <String>
    [-RemoveSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ExpirationDate <DateTime>
    -Reason <String>
    [-ConfigPairs <String[]>]
    [-Confirm]
    [-CreateSettingsGroup]
    [-Disable]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-MaxVersion <String>]
    [-MinVersion <String>]
    [-NameMatch <String>]
    [-Priority <Int32>]
    [-Scope <ExchangeSettingsScope>]
    [-ScopeFilter <String>]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroupGuid

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ExpirationDate <DateTime>
    -GuidMatch <Guid>
    -Reason <String>
    [-ConfigPairs <String[]>]
    [-Confirm]
    [-CreateSettingsGroup]
    [-Disable]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-Priority <Int32>]
    [-Scope <ExchangeSettingsScope>]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroupAdvanced

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -SettingsGroup <String>
    [-CreateSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroupGeneric

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ExpirationDate <DateTime>
    -Reason <String>
    [-CreateSettingsGroup]
    [-ConfigPairs <String[]>]
    [-GenericScopeName <String>]
    [-GenericScopeValue <String>]
    [-GroupName <String>]
    [-Confirm]
    [-Disable]
    [-DomainController <Fqdn>]
    [-Force]
    [-Priority <Int32>]
    [-Scope <ExchangeSettingsScope>]
    [-WhatIf]
    [<CommonParameters>]

UpdateSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-ExpirationDate <DateTime>]
    [-GroupName <String>]
    [-UpdateSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Priority <Int32>]
    [-ScopeFilter <String>]
    [-WhatIf]
    [<CommonParameters>]

RemoveMultipleSettings

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -ConfigPairs <String[]>
    [-GroupName <String>]
    [-RemoveSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

RemoveSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-GroupName <String>]
    [-RemoveSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

UpdateSettingsGroupAdvanced

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -SettingsGroup <String>
    [-UpdateSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

UpdateMultipleSettings

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -ConfigPairs <String[]>
    [-GroupName <String>]
    [-UpdateSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

EnableSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-EnableGroup <String>]
    [-DisableGroup <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

Description

예제

예 1

Set-ExchangeSettings Audit -UpdateSetting -ConfigName AuditLogPumperEnabled -ConfigValue $true -Reason "Enable Unified Audit Logging"

매개 변수

-ClearHistory

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

ClearHistory 스위치는 Exchange 설정 개체에 대한 수정 기록의 항목을 지우도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

매개 변수 속성

매개 변수 집합

-ConfigName

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

ConfigName 매개 변수는 Exchange 설정 개체에서 추가, 제거 또는 업데이트하려는 사용 가능한 Exchange 설정을 지정합니다. 이 매개 변수의 유효한 값은 New-ExchangeSettings cmdlet의 Name 매개 변수에 지정된 구성 스키마에 의해 결정됩니다.

추가 및 업데이트 작업의 경우 ConfigValue 매개 변수를 사용하여 설정의 실제 값을 지정해야 합니다. ConfigPairs 매개 변수에는 ConfigName 매개 변수를 사용할 수 없습니다.

매개 변수 속성

매개 변수 집합

-ConfigPairs

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

ConfigName 매개 변수는 Exchange 설정 개체에서 추가, 제거 또는 업데이트하려는 사용 가능한 Exchange 설정을 지정합니다. 이 매개 변수의 유효한 값은 New-ExchangeSettings cmdlet의 Name 매개 변수에 지정된 구성 스키마에 의해 결정됩니다. 값의 구문은 입니다 <Key>=<Value>. 여러 값을 쉼표로 구분할 수 있습니다.

ConfigName 또는 ConfigValue 매개 변수에는 ConfigPairs 매개 변수를 사용할 수 없습니다.

매개 변수 속성

매개 변수 집합

-ConfigValue

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

ConfigValue 매개 변수는 ConfigName 매개 변수를 사용하여 지정한 Exchange 설정의 값을 지정합니다. 값은 설정 유형(숫자, 시간 범위, $true 또는 $false 등)에 따라 결정됩니다.

ConfigPairs 매개 변수에는 ConfigValue 매개 변수를 사용할 수 없습니다.

매개 변수 속성

매개 변수 집합

-Confirm

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 이 스위치가 cmdlet에 미치는 영향은 계속하기 전에 cmdlet에 확인이 필요한지 여부에 따라 달라집니다.

• 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
• 대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 확인 스위치를 지정하면 계속하기 전에 명령을 승인하도록 강제하는 일시 중지가 발생합니다.

이 cmdlet에는 기본 제공 일시 중지가 있으므로 을 사용하여 -Confirm:$false 확인을 건너뜁니다.

매개 변수 속성

매개 변수 집합

-CreateSettingsGroup

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

CreateSettingsGroup 스위치는 관련된 Exchange 설정 그룹인 Exchange 설정 그룹을 만들게 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

설정 그룹을 구성하는 방법에 따라 GroupName 매개 변수 또는 SettingsGroup 매개 변수를 사용하여 Exchange 설정 그룹의 이름을 지정합니다. 기존 설정 그룹의 이름을 바꿀 수 없으므로 신중하게 선택합니다.

매개 변수 속성

매개 변수 집합

-Disable

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

사용 안 함 스위치는 Exchange 설정 그룹을 사용하지 않도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

CreateSettingsGroup 스위치에서만 이 스위치를 사용할 수 있습니다.

이 스위치를 사용하여 Exchange 설정 그룹을 사용하도록 설정하려면 이 정확한 구문 -Disable:$false를 사용합니다.

매개 변수 속성

매개 변수 집합

-DisableGroup

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

DisableGroup 매개 변수는 사용하지 않도록 설정할 Exchange 설정 그룹의 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

같은 명령에서 DisableGroup 및 EnableGroup 매개 변수를 함께 사용하여 서로 다른 Exchange 설정 그룹을 동시에 사용하거나 사용하지 않도록 설정할 수 있습니다.

매개 변수 속성

매개 변수 집합

-DomainController

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

매개 변수 속성

매개 변수 집합

-EnableGroup

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

EnableGroup 매개 변수는 사용하려는 비활성화된 Exchange 설정 그룹의 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

같은 명령에서 DisableGroup 및 EnableGroup 매개 변수를 함께 사용하여 서로 다른 Exchange 설정 그룹을 동시에 사용하거나 사용하지 않도록 설정할 수 있습니다.

매개 변수 속성

매개 변수 집합

-ExpirationDate

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

ExpirationDate 매개 변수는 지정된 Exchange 설정 그룹에 의해 정의된 Exchange 설정의 종료 날짜/시간을 지정합니다.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 컴퓨터가 짧은 날짜 형식 MM/dd/yyyy를 사용하도록 구성된 경우 2018년 9월 1일을 지정하려면 2018년 9월 1일을 입력합니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

CreateSettingsGroup 또는 UpdateSettings 그룹 매개 변수와 함께 ExpirationDate 매개 변수만 사용할 수 있습니다.

매개 변수 속성

매개 변수 집합

-Force

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

강제 스위치는 경고 또는 확인 메시지를 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

관리 입력에 대한 확인 메시지를 표시하는 것이 부적절한 경우 이 스위치를 사용하여 작업을 프로그래밍 방식으로 실행할 수 있습니다.

매개 변수 속성

매개 변수 집합

-GenericScopeName

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

GenericScopeName 매개 변수는 scope 이름을 지정합니다. 사용 가능한 값은 Exchange 설정 개체의 스키마에 의해 결정됩니다.

매개 변수 속성

매개 변수 집합

-GenericScopeValue

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

GenericScopeValue 매개 변수는 GenericScopeName 매개 변수에 지정된 scope 값을 지정합니다. 사용 가능한 값은 Exchange 설정 개체의 스키마에 의해 결정됩니다.

매개 변수 속성

매개 변수 집합

-GroupName

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

GroupName 매개 변수는 그룹 작업에서 Exchange 설정 그룹의 이름을 지정합니다. 예시:

• Exchange 설정 그룹을 만들고 그룹 scope 및 우선 순위를 동시에 구성합니다.
• 기존 Exchange 설정 그룹의 ExpirationDate, Priority 및 ScopeFilter 값을 수정합니다.
• 기존 Exchange 설정 그룹을 제거합니다.
• 기존 Exchange 설정 그룹에서 Exchange 설정 개체를 추가, 제거 또는 업데이트합니다.

값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

매개 변수 속성

매개 변수 집합

-GuidMatch

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

GuidMatch 매개 변수는 개체의 GUID(예: 사서함 데이터베이스의 GUID)에 따라 Exchange 설정 그룹의 scope 지정합니다. 이 매개 변수는 포리스트 이외의 모든 Scope 매개 변수 값에 사용할 수 있습니다.

GroupName 매개 변수와 함께 CreateSettingsGroup 스위치를 사용하여 Exchange 설정 그룹을 만드는 경우에만 GuidMatch 매개 변수를 사용합니다.

GenericScopeName, GenericScopeValue, MaxVersion, MinVersion 또는 NameMatch 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

매개 변수 속성

매개 변수 집합

-Identity

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Identity 매개 변수는 구성하려는 Exchange 설정이 포함된 기존 Exchange 설정 개체의 이름을 지정합니다.

이 매개 변수의 값은 Exchange 설정 개체를 만들 때 New-ExchangeSetting cmdlet의 Name 매개 변수 값입니다.

매개 변수 속성

매개 변수 집합

-MaxVersion

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

MaxVersion 매개 변수는 개체 버전(예: 서버에 설치된 Exchange 버전)에 따라 Exchange 설정 그룹의 scope 지정합니다. 이 매개 변수는 포리스트 이외의 모든 Scope 매개 변수 값에 사용할 수 있습니다.

GroupName 매개 변수와 함께 CreateSettingsGroup 스위치를 사용하여 Exchange 설정 그룹을 만드는 경우에만 MaxVersion 매개 변수를 MinVersion 매개 변수와 함께 사용합니다.

GuidMatch, GenericScopeName 또는 GenericScopeValue 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

매개 변수 속성

매개 변수 집합

-MinVersion

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

MinVersion 매개 변수는 개체 버전(예: 서버에 설치된 Exchange 버전)에 따라 Exchange 설정 그룹의 scope 지정합니다. 이 매개 변수는 포리스트 이외의 모든 Scope 매개 변수 값에 사용할 수 있습니다.

GroupName 매개 변수와 함께 CreateSettingsGroup 스위치를 사용하여 Exchange 설정 그룹을 만드는 경우에만 MinVersion 매개 변수를 MaxVersion 매개 변수와 함께 사용합니다.

GuidMatch, GenericScopeName 또는 GenericScopeValue 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

매개 변수 속성

매개 변수 집합

-NameMatch

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

NameMatch 매개 변수는 개체 이름(예: 프로세스 이름)에 따라 Exchange 설정 그룹의 scope 지정합니다. 이 매개 변수는 포리스트 이외의 모든 Scope 매개 변수 값에 사용할 수 있습니다.

GroupName 매개 변수와 함께 CreateSettingsGroup 스위치를 사용하여 Exchange 설정 그룹을 만드는 경우에만 NameMatch 매개 변수를 사용합니다.

GuidMatch, GenericScopeName 또는 GenericScopeValue 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

매개 변수 속성

매개 변수 집합

-Priority

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Priority 매개 변수는 Exchange 설정 그룹의 우선 순위를 지정합니다. 모든 그룹의 우선 순위 값은 고유해야 합니다. 우선 순위 값이 낮을수록 더 높은 우선 순위가 표시됩니다.

매개 변수 속성

매개 변수 집합

-Reason

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Reason 매개 변수는 Exchange 설정 또는 설정 그룹이 만들어지거나 수정된 이유에 대한 설명을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

매개 변수 속성

매개 변수 집합

-RemoveSetting

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

RemoveSetting 스위치는 Exchange 설정 개체에서 기존 Exchange 설정을 제거한다고 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

ConfigPairs 매개 변수 또는 ConfigName 매개 변수를 사용하여 제거할 설정을 지정합니다.

매개 변수 속성

매개 변수 집합

-RemoveSettingsGroup

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

RemoveSettingsGroup 스위치는 Exchange 설정 그룹을 제거한다고 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

GroupName 매개 변수를 사용하여 제거할 Exchange 설정 그룹을 지정합니다.

매개 변수 속성

매개 변수 집합

-Scope

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Scope 매개 변수는 Exchange 설정 개체의 scope 지정합니다. 유효한 값은 다음과 같습니다.

• Dag
• Database
• 포리스트
• 일반
• 조직
• 프로세스
• 서버
• 사용자

매개 변수 속성

매개 변수 집합

-ScopeFilter

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

ScopeFilter 매개 변수는 OPATH 필터 구문을 사용하여 Exchange 설정 그룹 기반의 scope 지정합니다. 구문은 (예: "ServerRole -like 'Mailbox*'")입니다 "Property -ComparisonOperator 'Value'" .

• 전체 OPATH 필터를 큰따옴표 " "로 묶습니다. 필터에 시스템 값(예 $true: , $false또는 $null)이 포함된 경우 대신 작은따옴표 ' 를 사용합니다. 이 매개 변수는 문자열(시스템 블록이 아님)이지만 중괄호 { }를 사용할 수도 있지만 필터에 변수가 없는 경우에만 사용할 수 있습니다.
• 속성은 필터링 가능한 속성입니다.
• ComparisonOperator는 OPATH 비교 연산자입니다(예 -eq : 같음 및 -like 문자열 비교의 경우). 비교 연산자에 대한 자세한 내용은 about_Comparison_Operators 참조하세요.
• 값은 검색할 속성 값입니다. 텍스트 값과 변수를 작은따옴표('Value' 또는 '$Variable')로 묶습니다. 변수 값에 작은따옴표가 포함된 경우 변수를 올바르게 확장하려면 작은따옴표를 식별(이스케이프)해야 합니다. 예를 들어 대신 를 '$User'사용합니다 '$($User -Replace "'","''")'. 정수 또는 시스템 값을 따옴표로 묶지 마세요(예: , , $true$false또는 $null 를 대신 사용500).

논리 연산자 -and 및 -or를 사용하여 여러 검색 조건을 함께 연결할 수 있습니다. 예: "Criteria1 -and Criteria2" 또는 "(Criteria1 -and Criteria2) -or Criteria3".

Exchange의 OPATH 필터에 대한 자세한 내용은 추가 OPATH 구문 정보를 참조하세요.

Scope 매개 변수 및 포리스트 또는 기타 scope 관련 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

이 매개 변수는 GroupName 매개 변수와 함께 UpdateSettingsGroup 스위치를 사용하여 Exchange 설정 그룹을 업데이트하는 경우에만 사용합니다.

매개 변수 속성

매개 변수 집합

-SettingsGroup

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

SettingsGroup 매개 변수는 새 설정 그룹을 만들거나 기존 설정 그룹을 수정하는 데 사용되는 기존 Exchange 설정 그룹을 지정합니다.

GroupName 매개 변수에는 SettingsGroup 매개 변수를 사용할 수 없습니다.

매개 변수 속성

매개 변수 집합

-UpdateSetting

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

UpdateSetting 스위치는 기존 Exchange 설정 개체에서 Exchange 설정을 업데이트하고 있음을 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

ConfigPairs 매개 변수 또는 ConfigName 및 ConfigValue 매개 변수를 사용하여 Exchange 설정을 구성합니다.

매개 변수 속성

매개 변수 집합

-UpdateSettingsGroup

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

UpdateSettingsGroup 스위치는 Exchange 설정 그룹을 수정하고 있음을 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

설정 그룹을 구성하는 방법에 따라 GroupName 매개 변수 또는 SettingsGroup 매개 변수를 사용하여 수정할 Exchange 설정 그룹을 지정합니다.

매개 변수 속성

매개 변수 집합

-WhatIf

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

WhatIf 스위치는 명령을 변경하지 않고 수행하는 작업을 보여줍니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

매개 변수 속성

매개 변수 집합

CommonParameters