Set-ADServerSettings

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

Используйте командлет Set-AdServerSettings для управления средой доменные службы Active Directory (AD DS) в текущем сеансе командной консоли Exchange. Командлет Set-AdServerSettings заменяет переменную сеанса AdminSessionADSettings, которая использовалась в Exchange Server 2007 году.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Set-ADServerSettings
   -RunspaceServerSettings <RunspaceServerSettingsPresentationObject>
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]
Set-ADServerSettings
   [-ConfigurationDomainController <Fqdn>]
   [-PreferredGlobalCatalog <Fqdn>]
   [-RecipientViewRoot <String>]
   [-SetPreferredDomainControllers <MultiValuedProperty>]
   [-ViewEntireForest <Boolean>]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]
Set-ADServerSettings
   [[-PreferredServer] <Fqdn>]
   [-RecipientViewRoot <String>]
   [-ViewEntireForest <Boolean>]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Описание

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Set-AdServerSettings -RecipientViewRoot "contoso.com/Marketing Users"

В этом примере задается область получателей для подразделения "Пользователи маркетинга" в домене contoso.com для текущего сеанса.

Пример 2

Set-AdServerSettings -ViewEntireForest $true -PreferredGlobalCatalog gc1.contoso.com

В данном примере задается область текущего сеанса для всего леса и назначается gc1.contoso.com в качестве основного сервера глобального каталога.

Параметры

-ConfigurationDomainController

Параметр ConfigurationDomainController указывает полное доменное имя (FQDN) контроллера домена конфигурации, который будет использоваться для чтения сведений о конфигурации Exchange в этом сеансе.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

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

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-PreferredGlobalCatalog

Параметр PreferredGlobalCatalog определяет полное доменное имя (FQDN) сервера глобального каталога, которое будет использоваться для чтения сведений о получателях в данном сеансе.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-PreferredServer

Параметр PreferredServer определяет полное доменное имя (FQDN) контроллера домена, которое будет использоваться для данного сеанса.

Type:Fqdn
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RecipientViewRoot

Параметр RecipientViewRoot определяет подразделение (OU), которое будет включено в область получателей для данного сеанса. При указании области получателей с данным параметром возвращаются только получатели, включенные в область. Чтобы указать подразделение, используйте синтаксис <FQDN of domain>/<OU tree>.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RunspaceServerSettings

Параметр RunspaceServerSettings указывает, необходимо ли передать весь объект конфигурации в команду для обработки. Этот параметр главным образом используется в сценариях, в которых весь объект должен быть передан команде.

Type:RunspaceServerSettingsPresentationObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SetPreferredDomainControllers

Параметр SetPreferredDomainControllers указывает список контроллеров домена, используемых для чтения сведений из Active Directory в этом сеансе. Необходимо указать полные доменные имена контроллеров домена. При указании нескольких доменов их следует разделять запятыми.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ViewEntireForest

Параметр ViewEntireForest определяет, должны ли в данном сеансе просматриваться и управляться все объекты в лесу. Допустимые значения: $true или $false.

При указании значения $true значение, хранящееся в параметре RecipientViewRoot, удаляется, а всех получателей в лесу можно просмотреть и управлять ими.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

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

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.