New-RemoteMailbox

Синтаксис

Default

New-RemoteMailbox
    [-Name] <String>
    -Password <SecureString>
    -UserPrincipalName <String>
    [-ACLableSyncedObjectEnabled]
    [-Alias <String>]
    [-Archive]
    [-Confirm]
    [-DisplayName <String>]
    [-DomainController <Fqdn>]
    [-FirstName <String>]
    [-ImmutableId <String>]
    [-Initials <String>]
    [-LastName <String>]
    [-ModeratedBy <MultiValuedProperty>]
    [-ModerationEnabled <Boolean>]
    [-OnPremisesOrganizationalUnit <OrganizationalUnitIdParameter>]
    [-PrimarySmtpAddress <SmtpAddress>]
    [-RemotePowerShellEnabled <Boolean>]
    [-RemoteRoutingAddress <ProxyAddress>]
    [-ResetPasswordOnNextLogon <Boolean>]
    [-SamAccountName <String>]
    [-SendModerationNotifications <TransportModerationNotificationFlags>]
    [-WhatIf]
    [<CommonParameters>]

Room

New-RemoteMailbox
    [-Name] <String>
    [-Password <SecureString>]
    [-Room]
    [-UserPrincipalName <String>]
    [-ACLableSyncedObjectEnabled]
    [-Alias <String>]
    [-Archive]
    [-Confirm]
    [-DisplayName <String>]
    [-DomainController <Fqdn>]
    [-FirstName <String>]
    [-ImmutableId <String>]
    [-Initials <String>]
    [-LastName <String>]
    [-ModeratedBy <MultiValuedProperty>]
    [-ModerationEnabled <Boolean>]
    [-OnPremisesOrganizationalUnit <OrganizationalUnitIdParameter>]
    [-PrimarySmtpAddress <SmtpAddress>]
    [-RemotePowerShellEnabled <Boolean>]
    [-RemoteRoutingAddress <ProxyAddress>]
    [-ResetPasswordOnNextLogon <Boolean>]
    [-SamAccountName <String>]
    [-SendModerationNotifications <TransportModerationNotificationFlags>]
    [-WhatIf]
    [<CommonParameters>]

Equipment

New-RemoteMailbox
    [-Name] <String>
    [-Equipment]
    [-Password <SecureString>]
    [-UserPrincipalName <String>]
    [-ACLableSyncedObjectEnabled]
    [-Alias <String>]
    [-Archive]
    [-Confirm]
    [-DisplayName <String>]
    [-DomainController <Fqdn>]
    [-FirstName <String>]
    [-ImmutableId <String>]
    [-Initials <String>]
    [-LastName <String>]
    [-ModeratedBy <MultiValuedProperty>]
    [-ModerationEnabled <Boolean>]
    [-OnPremisesOrganizationalUnit <OrganizationalUnitIdParameter>]
    [-PrimarySmtpAddress <SmtpAddress>]
    [-RemotePowerShellEnabled <Boolean>]
    [-RemoteRoutingAddress <ProxyAddress>]
    [-ResetPasswordOnNextLogon <Boolean>]
    [-SamAccountName <String>]
    [-SendModerationNotifications <TransportModerationNotificationFlags>]
    [-WhatIf]
    [<CommonParameters>]

Shared

New-RemoteMailbox
    [-Name] <String>
    [-Shared]
    [-Password <SecureString>]
    [-UserPrincipalName <String>]
    [-ACLableSyncedObjectEnabled]
    [-Alias <String>]
    [-Archive]
    [-Confirm]
    [-DisplayName <String>]
    [-DomainController <Fqdn>]
    [-FirstName <String>]
    [-ImmutableId <String>]
    [-Initials <String>]
    [-LastName <String>]
    [-ModeratedBy <MultiValuedProperty>]
    [-ModerationEnabled <Boolean>]
    [-OnPremisesOrganizationalUnit <OrganizationalUnitIdParameter>]
    [-PrimarySmtpAddress <SmtpAddress>]
    [-RemotePowerShellEnabled <Boolean>]
    [-RemoteRoutingAddress <ProxyAddress>]
    [-ResetPasswordOnNextLogon <Boolean>]
    [-SamAccountName <String>]
    [-SendModerationNotifications <TransportModerationNotificationFlags>]
    [-WhatIf]
    [<CommonParameters>]

AccountDisabled

New-RemoteMailbox
    [-Name] <String>
    [-AccountDisabled]
    [-Password <SecureString>]
    [-UserPrincipalName <String>]
    [-ACLableSyncedObjectEnabled]
    [-Alias <String>]
    [-Archive]
    [-Confirm]
    [-DisplayName <String>]
    [-DomainController <Fqdn>]
    [-FirstName <String>]
    [-ImmutableId <String>]
    [-Initials <String>]
    [-LastName <String>]
    [-ModeratedBy <MultiValuedProperty>]
    [-ModerationEnabled <Boolean>]
    [-OnPremisesOrganizationalUnit <OrganizationalUnitIdParameter>]
    [-PrimarySmtpAddress <SmtpAddress>]
    [-RemotePowerShellEnabled <Boolean>]
    [-RemoteRoutingAddress <ProxyAddress>]
    [-ResetPasswordOnNextLogon <Boolean>]
    [-SamAccountName <String>]
    [-SendModerationNotifications <TransportModerationNotificationFlags>]
    [-WhatIf]
    [<CommonParameters>]

Описание

Примеры

Пример 1

$Credentials = Get-Credential

New-RemoteMailbox -Name "Kim Akers" -Password $Credentials.Password -UserPrincipalName kim@corp.contoso.com

Пример 2

$Credentials = Get-Credential

New-RemoteMailbox -Name "Kim Akers" -Password $Credentials.Password -UserPrincipalName kim@corp.contoso.com -OnPremisesOrganizationalUnit "corp.contoso.com/Archive Users" -Archive

Параметры

-AccountDisabled

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

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

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

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

-ACLableSyncedObjectEnabled

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

Параметр ACLableSyncedObjectEnabled указывает, является ли удаленный почтовый ящик ACLableSyncedMailboxUser. С этим параметром не нужно указывать значение.

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

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

-Alias

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

Параметр Alias указывает псевдоним Exchange (также называемый почтовым псевдонимом) получателя. Это значение идентифицирует получателя как объект, поддерживающий почту. Не следует путать его с несколькими электронными адресами для одного и того же получателя (также называемыми прокси-адресами). У получателя может быть только одно значение Alias. Максимальная длина: 64 символа.

Значение Alias может содержать буквы, цифры и следующие символы:

• !, #, %, *, +, -, /, =, ?, ^, _, и ~.
• $, &, ', ', {, }и | необходимо экранировать (например -Alias what`'snew, ) или все значение, заключенное в одинарные кавычки (например, -Alias 'what'snew'). Символ & не поддерживается в значении Псевдоним для синхронизации Microsoft Entra Connect.
• Точки (.) должны быть окружены другими допустимыми символами (например, help.desk).
• Символы Юникода от U+00A1 до U+00FF.

Если при создании получателя не указать электронный адрес, то заданное значение Alias будет использовано для создания основного электронного адреса (alias@domain). Поддерживаемые символы Юникода сопоставляются с наиболее подходящими текстовыми символами US-ASCII. Например, U+00F6 (ö) изменяется на oe в основной адрес электронной почты.

Если при создании получателя не использовать параметр Alias, то в качестве значения свойства Alias будет использовано значение другого обязательного параметра:

• Для получателей с учетными записями пользователей (например, почтовые ящики пользователей и почтовые пользователи) используется левая часть параметра MicrosoftOnlineServicesID или параметр UserPrincipalName. Например, helpdesk@contoso.onmicrosoft.com возвращает значение helpdeskсвойства Alias .
• Для получателей без учетных записей пользователей (например, почтовые ящики переговорных комнат, почтовые контакты и группы рассылки) используется значение параметра Name. Пробелы будут удалены, а неподдерживаемые символы преобразованы в знаки вопроса (?).

Если изменить значение параметра Alias существующего получателя, основной электронный адрес будет автоматически обновлен только в локальных средах, где в отношении получателя действуют политики электронных адресов (для получателя свойство EmailAddressPolicyEnabled имеет значение True).

Параметр Alias никогда не создает и не изменяет основной электронный адрес почтового контакта или почтового пользователя.

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

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

-Archive

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

Параметр Архив указывает, следует ли также создавать архивный почтовый ящик в службе. С этим параметром не нужно указывать значение.

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

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

-Confirm

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

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

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

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

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

-DisplayName

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

Параметр DisplayName указывает отображаемое имя почтового пользователя и связанного почтового ящика в службе. Отображаемое имя отображается в Центре администрирования Exchange, в списках адресов и в Outlook. Максимальная длина имени составляет 256 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Если вы не используете параметр DisplayName, для отображаемого имени указывается значение параметра Name.

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

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

-DomainController

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

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

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

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

-Equipment

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

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

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

Этот переключатель нельзя использовать с параметром Room.

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

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

-FirstName

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

Параметр FirstName указывает имя пользователя.

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

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

-ImmutableId

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

Параметр ImmutableId используется синхронизацией GAL (GALSync) и задает уникальный и неизменяемый идентификатор в виде SMTP-адреса почтового ящика Exchange, используемого для федеративного делегирования при запросе маркеров SAML. Если федерация настроена для этого почтового ящика и этот параметр не задан при создании почтового ящика, Exchange создает значение для неизменяемого идентификатора на основе ExchangeGUID почтового ящика и пространства имен федеративной учетной записи, например 7a78e7c8-620e-4d85-99d3-c90d90f29699@mail.contoso.com.

Необходимо задать параметр ImmutableId, если службы федерации Active Directory (AD FS) (AD FS) развернут, чтобы разрешить единый вход в локальный почтовый ящик, а ad FS настроен для использования атрибута, отличного от ExchangeGUID, для запросов маркера входа. Exchange и AD FS должны запрашивать один и тот же маркер для одного и того же пользователя, чтобы обеспечить правильную функциональность для сценария развертывания Exchange в нескольких локальных средах.

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

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

-Initials

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

Параметр Initials указывает отчество пользователя.

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

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

-LastName

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

Параметр LastName указывает фамилию пользователя.

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

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

-ModeratedBy

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

Параметр ModeratedBy определяет одного или нескольких модераторов для данного получателя. Модератор утверждает сообщения, отправленные получателю, перед их доставкой. В качестве модератора должен выступать почтовый ящик, почтовый пользователь или почтовый контакт в организации. Для идентификации модератора можно использовать любое уникальное значение. Например:

• Имя
• Псевдоним
• различающееся имя (DN);
• различающееся имя (DN);
• Каноническое краткое имя
• GUID

Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

С помощью этого параметра необходимо указать как минимум одного модератора, если для параметра ModerationEnabled задано значение $true.

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

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

-ModerationEnabled

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

Параметр ModerationEnabled указывает, включена ли модерация для этого получателя. Допустимые значения:

• $true. Для этого получателя включена модерация. Сообщения, отправленные этому получателю, должны быть утверждены модератором перед доставкой сообщений.
• $true. Модерирование включено для этого получателя. Это значение является значением по умолчанию.

Для указания модераторов используется параметр ModeratedBy.

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

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

-Name

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

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

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

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

-OnPremisesOrganizationalUnit

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

Параметр OnPremisesOrganizationalUnit указывает подразделение локальной организации, в которое добавляется новый почтовый ящик (например, redmond.contoso.com/Users).

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

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

Этот параметр не оказывает влияния на почтовый ящик в службе.

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

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

-Password

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

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

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

• (ConvertTo-SecureString -String '<password>' -AsPlainText -Force).
• Перед выполнением этой команды сохраните пароль как переменную (например, $password = Read-Host "Enter password" -AsSecureString), а затем используйте переменную ($password) в качестве значения.
• (Get-Credential).password запрос на безопасный ввод пароля при выполнении этой команды.

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

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

-PrimarySmtpAddress

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

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

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

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

-RemotePowerShellEnabled

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

Параметр RemotePowerShellEnabled указывает, имеет ли пользователь доступ к Exchange PowerShell. Допустимые значения:

• $true. Пользователь имеет доступ к Exchange Online PowerShell, командной консоли Exchange и Центру администрирования Exchange (EAC). Это значение является значением по умолчанию.
• $false. У пользователя нет доступа к Exchange Online PowerShell, командной консоли Exchange или EAC.

Доступ к Exchange PowerShell необходим, даже если вы пытаетесь открыть командную консоль Exchange или EAC на локальном сервере Exchange Server.

Взаимодействие пользователя с любым из этих интерфейсов управления по-прежнему контролируется назначенными ему разрешениями управления доступом на основе ролей (RBAC).

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

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

-RemoteRoutingAddress

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

Параметр RemoteRoutingAddress задает SMTP-адрес почтового ящика в службе, связанного с этим пользователем. Этот адрес создается автоматически, если служба изначально настроена в формате <your domain>.mail.onmicrosoft.com.

Если вы настроили поток обработки почты между локальной организацией и службой, например в гибридном развертывании, указывать этот параметр необязательно. Адрес удаленной маршрутизации определяется автоматически и назначается политике адресов электронной почты для локальной организации мастером гибридной конфигурации.

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

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

-ResetPasswordOnNextLogon

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

Параметр ResetPasswordOnNextLogon указывает, должен ли пользователь изменить пароль при следующем входе в систему. Допустимые значения:

• $true. Пользователь должен изменить пароль при следующем входе в систему.
• $true. Это значение является значением по умолчанию.

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

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

-Room

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

Параметр Room указывает, что почтовый ящик в службе должен быть создан как почтовый ящик ресурса помещения. С этим параметром не нужно указывать значение.

Параметр Room нельзя использовать при указании параметра Equipment.

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

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

-SamAccountName

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

Параметр SamAccountName (также известный как имя группы или учетная запись пользователя в версиях, предшествующих Windows 2000) определяет идентификатор объекта, совместимый с более ранними версиями клиента Microsoft Windows и серверных операционных систем. Значение может содержать буквы, цифры, пробелы, точки (.) и следующие символы: !, #, $, %, ^, &, -, _, {, }и ~. В качестве последнего символа невозможно использовать точку. Символы Юникода разрешены, но символы с акцентами могут вызывать столкновения (например, совпадение o и ö). Максимальная длина составляет 20 символов.

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

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

-SendModerationNotifications

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

Службы клиентского доступа выступают в роли прокси-сервера, передавая подключения клиентов во внутренние службы на локальных или удаленных серверах почтовых ящиков. Допустимые значения:

• Всегда: уведомлять всех отправителей о том, что их сообщения не утверждены. Это значение является значением по умолчанию.
• Always. Уведомлять всех отправителей о том, что их сообщения не утверждены. Это значение используется по умолчанию.
• Internal. Уведомлять отправителей вашей организации, если их сообщения не утверждены.

Этот параметр имеет смысл, только если модерация включена (параметр ModerationEnabled имеет значение $true).

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

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

-Shared

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

Примечание. Этот параметр доступен только в Exchange 2013 с накопительным пакетом обновления 21 (CU21) или более поздней версии, а также в Exchange 2016 с накопительным пакетом обновления 10 (CU10) или более поздней версии. Чтобы использовать этот параметр, необходимо также запустить setup.exe /PrepareAD. Дополнительные сведения см. в разделе KB4133605.

Параметр Общий указывает, что почтовый ящик в службе должен быть создан как общий почтовый ящик. С этим параметром не нужно указывать значение.

Этот переключатель нельзя использовать с коммутаторами "Комната" или "Оборудование".

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

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

-UserPrincipalName

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

Параметр UserPrincipalName определяет имя, которое используется при входе, для учетной записи пользователя. Имя участника-пользователя использует формат адреса электронной почты: username@domain. Как правило, значением домена является домен, в котором находится учетная запись пользователя.

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

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

-WhatIf

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

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

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

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

CommonParameters

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

Input types

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

Output types