Set-ManagementScope

Синтаксис

DatabaseFilter

Set-ManagementScope
    [-Identity] <ManagementScopeIdParameter>
    -DatabaseRestrictionFilter <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

ServerFilter

Set-ManagementScope
    [-Identity] <ManagementScopeIdParameter>
    -ServerRestrictionFilter <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

RecipientFilter

Set-ManagementScope
    [-Identity] <ManagementScopeIdParameter>
    [-RecipientRestrictionFilter <String>]
    [-RecipientRoot <OrganizationalUnitIdParameter>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

Описание

Примеры

Пример 1

Set-ManagementScope "Seattle Mailboxes" -RecipientRestrictionFilter "City -eq 'Seattle' -and RecipientType -eq 'UserMailbox'"

Пример 2

Set-ManagementScope "Sales Recipients" -RecipientRoot contoso.com/Sales

Пример 3

Set-ManagementScope "Vancouver Servers" -ServerRestrictionFilter "ServerSite -eq 'NA-CDN-Vancouver,CN=Sites,CN=Configuration,DC=contoso,DC=com"}'"

Параметры

-Confirm

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online, Exchange Online Protection

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

• Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
• Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.

Свойства параметра

Наборы параметров

-DatabaseRestrictionFilter

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.

Этот параметр доступен только в локальной среде Exchange.

Параметр DatabaseRestrictionFilter использует синтаксис фильтра OPATH для указания баз данных, включенных в область. Используется следующий синтаксис: "Property -ComparisonOperator 'Value'".

• Заключите весь фильтр OPATH в двойные кавычки "". Если фильтр содержит системные значения (например, $true, $false или $null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные.
• Property — это свойство с поддержкой фильтрации. Список свойств фильтруемой базы данных см. в статье Общие сведения о областях ролей управления.
• ComparisonOperator — это оператор сравнения OPATH (например -eq , для равных и -like для сравнения строк). Подробнее об операторах сравнения см. в статье about_Comparison_Operators.
• Value — это значение свойства для поиска. Заключите текстовые значения и переменные в одиночные кавычки ('Value' или '$Variable'). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо '$User' используйте '$($User -Replace "'","''")'. Не заключайте целые числа или системные значения в кавычки (например, используйте 500, $true, $false, или $null вместо них).

Можно связать несколько условий поиска вместе с помощью логических операторов -and и -or. Например, "Criteria1 -and Criteria2" или "(Criteria1 -and Criteria2) -or Criteria3".

Подробные сведения о фильтрах OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.

Этот параметр нельзя использовать с параметрами RecipientRestrictionFilter, ServerRestrictionFilter, RecipientRoot, DatabaseList или ServerList.

Свойства параметра

Наборы параметров

-DomainController

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Свойства параметра

Наборы параметров

-Force

Применимо: Exchange Online, Exchange Online Protection

Этот параметр доступен только в облачной службе.

Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.

Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.

Свойства параметра

Наборы параметров

-Identity

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online, Exchange Online Protection

Параметр Identity указывает имя области управления, которое необходимо изменить. Если имя содержит пробелы, его необходимо заключить в кавычки (").

Свойства параметра

Наборы параметров

-Name

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online, Exchange Online Protection

Параметр Name указывает имя области управления. Имя области управления может содержать не более 64 символов. Если имя содержит пробелы, его необходимо заключить в кавычки (").

Свойства параметра

Наборы параметров

-RecipientRestrictionFilter

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online, Exchange Online Protection

Параметр RecipientRestrictionFilter использует синтаксис фильтра OPATH для указания получателей, включенных в область. Используется следующий синтаксис: "Property -ComparisonOperator 'Value'".

• Заключите весь фильтр OPATH в двойные кавычки "". Если фильтр содержит системные значения (например, $true, $false или $null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные.
• Свойство является фильтруемым свойством получателя. Сведения о свойствах фильтруемых получателей см . в разделе Фильтруемые свойства для параметра RecipientFilter.
• ComparisonOperator — это оператор сравнения OPATH (например -eq , для равных и -like для сравнения строк). Подробнее об операторах сравнения см. в статье about_Comparison_Operators.
• Value — это значение свойства для поиска. Заключите текстовые значения и переменные в одиночные кавычки ('Value' или '$Variable'). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо '$User' используйте '$($User -Replace "'","''")'. Не заключайте целые числа или системные значения в кавычки (например, используйте 500, $true, $false, или $null вместо них).

Можно связать несколько условий поиска вместе с помощью логических операторов -and и -or. Например, "Criteria1 -and Criteria2" или "(Criteria1 -and Criteria2) -or Criteria3".

Подробные сведения о фильтрах OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.

Этот параметр нельзя использовать с параметрами DatabaseRestrictionFilter, DatabaseList, ServerList или ServerRestrictionFilter.

Свойства параметра

Наборы параметров

-RecipientRoot

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online, Exchange Online Protection

Параметр RecipientRoot указывает подразделение, для которого необходимо применять фильтр, указанный с помощью параметра RecipientRestrictionFilter. Допустимые входные данные для этого параметра — это подразделение или домен, возвращаемые командлетом Get-OrganizationalUnit. Вы можете использовать любое значение, уникальным образом определяющее подразделение или домен. Пример:

• Имя
• Имя
• различающееся имя (DN);
• GUID

Этот параметр нельзя использовать с параметрами ServerRestrictionFilter или DatabaseRestrictionFilter.

Свойства параметра

Наборы параметров

-ServerRestrictionFilter

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.

Этот параметр доступен только в локальной среде Exchange.

Параметр ServerRestrictionFilter использует синтаксис фильтра OPATH для указания серверов, включенных в область. Используется следующий синтаксис: "Property -ComparisonOperator 'Value'".

• Заключите весь фильтр OPATH в двойные кавычки "". Если фильтр содержит системные значения (например, $true, $false или $null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные.
• Property — это свойство с поддержкой фильтрации. Список свойств фильтруемого сервера см. в разделе Общие сведения об областях ролей управления.
• ComparisonOperator — это оператор сравнения OPATH (например -eq , для равных и -like для сравнения строк). Подробнее об операторах сравнения см. в статье about_Comparison_Operators.
• Value — это значение свойства для поиска. Заключите текстовые значения и переменные в одиночные кавычки ('Value' или '$Variable'). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо '$User' используйте '$($User -Replace "'","''")'. Не заключайте целые числа или системные значения в кавычки (например, используйте 500, $true, $false, или $null вместо них).

Можно связать несколько условий поиска вместе с помощью логических операторов -and и -or. Например, "Criteria1 -and Criteria2" или "(Criteria1 -and Criteria2) -or Criteria3".

Подробные сведения о фильтрах OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.

Этот параметр нельзя использовать с параметрами RecipientRestrictionFilter, RecipientRoot, DatabaseRestrictionFilter, DatabaseList или ServerList.

Свойства параметра

Наборы параметров

-WhatIf

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online, Exchange Online Protection

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Свойства параметра

Наборы параметров

CommonParameters

Входные данные

Input types

Выходные данные

Output types

Примечания