Set-GlobalAddressList
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и параметры могут быть эксклюзивными для одной или другой среды.
Командлет Set-GlobalAddressList используется для изменения существующего глобального списка адресов.
В Exchange Online этот командлет доступен только в роли "Списки адресов", которая по умолчанию не назначена ни одной группе ролей. Чтобы использовать этот командлет, добавьте роль "Списки адресов" в группу ролей (например, в группу ролей "Управление организацией"). Подробнее см. в разделе Добавление роли в группу ролей.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (по умолчанию)
Set-GlobalAddressList
[-Identity] <GlobalAddressListIdParameter>
[-ConditionalCompany <MultiValuedProperty>]
[-ConditionalCustomAttribute1 <MultiValuedProperty>]
[-ConditionalCustomAttribute10 <MultiValuedProperty>]
[-ConditionalCustomAttribute11 <MultiValuedProperty>]
[-ConditionalCustomAttribute12 <MultiValuedProperty>]
[-ConditionalCustomAttribute13 <MultiValuedProperty>]
[-ConditionalCustomAttribute14 <MultiValuedProperty>]
[-ConditionalCustomAttribute15 <MultiValuedProperty>]
[-ConditionalCustomAttribute2 <MultiValuedProperty>]
[-ConditionalCustomAttribute3 <MultiValuedProperty>]
[-ConditionalCustomAttribute4 <MultiValuedProperty>]
[-ConditionalCustomAttribute5 <MultiValuedProperty>]
[-ConditionalCustomAttribute6 <MultiValuedProperty>]
[-ConditionalCustomAttribute7 <MultiValuedProperty>]
[-ConditionalCustomAttribute8 <MultiValuedProperty>]
[-ConditionalCustomAttribute9 <MultiValuedProperty>]
[-ConditionalDepartment <MultiValuedProperty>]
[-ConditionalStateOrProvince <MultiValuedProperty>]
[-Confirm]
[-DomainController <Fqdn>]
[-ForceUpgrade]
[-IncludedRecipients <WellKnownRecipientType>]
[-Name <String>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-RecipientFilter <String>]
[-WhatIf]
[<CommonParameters>]
Описание
Для условных параметров, используемых вместе с параметром IncludedRecipients, действуют следующие ограничения:
- Оператор EQV используется для всех значений свойств, как, например, в выражении "Отдел равно Продажи". Подстановочные знаки и частичные совпадения не поддерживаются.
- Если для одного свойства используется несколько значений, то всегда применяется оператор OR, как, например, в выражении "Отдел равно Продажи OR Маркетинг".
- Если используется несколько свойств, то всегда применяется оператор AND, как, например, в выражении "Отдел равно Продажи AND Компания равно Contoso".
Чтобы создать гибкие фильтры, использующие любое доступное свойство получателя и не на которые распространяются эти ограничения, можно использовать параметр RecipientFilter для создания настраиваемого фильтра OPATH.
Этот командлет нельзя использовать для замены предварительно подготовленного фильтра пользовательским фильтром OPATH или наоборот. Изменить можно только существующий фильтр.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Set-GlobalAddressList 96d0c505-eba8-4103-ad4f-577a1bf4ad7b -Name GALwithNewName
В этом примере глобальному списку адресов с идентификатором GUID 96d0c505-eba8-4103-ad4f-577a1bf4ad7b назначается новое имя «GALwithNewName».
Параметры
-ConditionalCompany
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCompany указывает заранее подготовленный фильтр, основанный на значении свойства получателя Company.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute1
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute1 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute1. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute10
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute10 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute10. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute11
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute11 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute11. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute12
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute12 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute12. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute13
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute13 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute13. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute14
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute14 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute14. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute15
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute15 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute15. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute2
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute2 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute2. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute3
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute3 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute3. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute4
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute4 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute4. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute5
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute5 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute5. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute6
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute6 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute6. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute7
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute7 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute7. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute8
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute8 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute8. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalCustomAttribute9
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalCustomAttribute9 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute9. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalDepartment
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalDepartment указывает заранее подготовленный фильтр, основанный на значении свойства получателя Department. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConditionalStateOrProvince
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр ConditionalStateOrProvince указывает заранее подготовленный фильтр, основанный на значении свойства получателя StateOrProvince. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".
Чтобы добавлять или удалять значения, не затрагивая имеющиеся записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Этот параметр доступен только в локальной среде Exchange.
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Свойства параметра
| Тип: | Fqdn |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ForceUpgrade
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Этот параметр доступен только в локальной среде Exchange.
Параметр ForceUpgrade подавляет сообщение подтверждения, которое появляется, если объект был создан в предыдущей версии Exchange. С этим параметром не нужно указывать значение.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр Identity указывает глобальный список адресов, который требуется изменить. Можно использовать любое значение, однозначно определяющее глобальный список адресов. Например:
- имя;
- различающееся имя (DN);
- GUID
Свойства параметра
| Тип: | GlobalAddressListIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IncludedRecipients
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр IncludedRecipients указывает заранее подготовленный фильтр, основанный на типе получателя. Допустимые значения:
- AllRecipients: Это значение используется только им самим.
- MailboxUsers
- MailContacts
- MailGroups
- MailUsers
- Resources: Это значение обозначает почтовые ящики помещения или оборудования.
Вы можете указать несколько значений, разделив их запятыми. Если вы используете несколько значений, необходимо применять логический оператор OR.
Свойства параметра
| Тип: | WellKnownRecipientType |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр Name указывает уникальное имя глобального списка адресов. Максимальная длина: 64 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RecipientContainer
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Этот параметр доступен только в локальной среде Exchange.
Параметр RecipientContainer указывает фильтр, основанный на расположении получателя в Active Directory. Допустимые значения для этого параметра — подразделение или домен, которые возвращаются с помощью командлета Get-OrganizationalUnit. Вы можете использовать любое значение, уникальным образом определяющее подразделение или домен. Пример:
- Имя
- Имя
- различающееся имя (DN);
- GUID
GUID
Свойства параметра
| Тип: | OrganizationalUnitIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RecipientFilter
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Параметр RecipientFilter задает фильтр OPATH, основанный на значении любого доступного свойства recipient. Вы можете использовать любой доступный оператор Windows PowerShell. Кроме того, поддерживаются подстановочные знаки и частичные совпадения. Для критериев поиска используется следующий синтаксис: "Property -ComparisonOperator 'Value'".
- Заключите весь фильтр OPATH в двойные кавычки "". Если фильтр содержит системные значения (например,
$true,$falseили$null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные. - Property — это свойство с поддержкой фильтрации. Список свойств с поддержкой фильтрации см. в статье Свойства с поддержкой фильтрации для параметра RecipientFilter.
- ComparisonOperator — это оператор сравнения OPATH (например
-eq, для равных и-likeдля сравнения строк). Подробнее об операторах сравнения см. в статье about_Comparison_Operators. - Value — это значение свойства для фильтрации. Заключите текстовые значения и переменные в одиночные кавычки (
'Value'или'$Variable'). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо'$User'используйте'$($User -Replace "'","''")'. Не заключайте целые числа или системные значения в кавычки (например, используйте500,$true,$false, или$nullвместо них). - В облачных средах невозможно использовать подстановочный знак в качестве первого символа. Например,
'Sales*'разрешено, а'*Sales'— нет. - В локальной среде Exchange подстановочные знаки действительны только в качестве первого или последнего символа. Например,
'Sales*'или'*Sales'разрешено, а'Sa*les'— нет.
Подробные сведения о фильтрах OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Online
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.