Поделиться через


Disconnect-ExchangeOnline

Этот командлет доступен только в модуле PowerShell Exchange Online. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.

Используйте командлет Disconnect-ExchangeOnline в модуле Exchange Online PowerShell, чтобы отключить подключения, созданные с помощью командлетов Connect-ExchangeOnline или Connect-IPPSSession.

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

Синтаксис

Disconnect-ExchangeOnline
          [-Confirm]
          [-WhatIf]
          [<CommonParameters>]
Disconnect-ExchangeOnline
          -ConnectionId <String[]>
          [-Confirm]
          [-WhatIf]
          [<CommonParameters>]
Disconnect-ExchangeOnline
          -ModulePrefix <String[]>
          [-Confirm]
          [-WhatIf]
          [<CommonParameters>]

Описание

Этот командлет аналогит командлетам Connect-ExchangeOnline и Connect-IPPSSession.

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

Команды отключения, скорее всего, завершатся ошибкой, если путь к профилю учетной записи, используемой для подключения, содержит специальные символы PowerShell (например, $). Обходной путь заключается в подключении с помощью другой учетной записи, которая не содержит специальных символов в пути к профилю.

Примеры

Пример 1

Disconnect-ExchangeOnline

В этом примере запрашивается подтверждение перед отключением от Exchange Online PowerShell или PowerShell для соответствия требованиям безопасности&.

Пример 2

Disconnect-ExchangeOnline -Confirm:$false

В этом примере автоматически отключается от Exchange Online PowerShell или PowerShell соответствия требованиям безопасности & без запроса на подтверждение или текста уведомления.

Пример 3

Disconnect-ExchangeOnline -ConnectionId 1a9e45e8-e7ec-498f-9ac3-0504e987fa85

В этом примере подключение PowerShell на основе REST Exchange Online отключается с указанным значением ConnectionId. Все другие удаленные подключения PowerShell к Exchange Online PowerShell или PowerShell соответствия требованиям безопасности & в том же окне Windows PowerShell также отключены.

Пример 4

Disconnect-ExchangeOnline -ModulePrefix Contoso,Fabrikam

В этом примере отключаются подключения PowerShell на основе REST Exchange Online, использующие указанные значения префикса. Все другие удаленные подключения PowerShell к Exchange Online PowerShell или PowerShell соответствия требованиям безопасности & в том же окне Windows PowerShell также отключены.

Параметры

-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 Online

-ConnectionId

Примечание. Этот параметр доступен в модуле 3.2.0 или более поздней версии.

Параметр ConnectionId указывает подключения REST API для отключения с помощью ConnectionId. ConnectionId — это значение GUID в выходных данных командлета Get-ConnectionInformation, который однозначно идентифицирует подключение, даже если открыто несколько подключений. Можно указать несколько значений ConnectionId, разделенных запятыми.

Не используйте этот параметр с параметром ModulePrefix.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ModulePrefix

Примечание. Этот параметр доступен в модуле 3.2.0 или более поздней версии.

Параметр ModulePrefix указывает подключения REST API, отключаемые с помощью ModulePrefix. При использовании параметра Prefix с командлетом Connect-ExchangeOnline указанный текст добавляется к именам всех командлетов Exchange Online (например, Get-InboundConnector становится Get-ContosoInboundConnector). Значение ModulePrefix отображается в выходных данных командлета Get-ConnectionInformation. Можно указать несколько значений ModulePrefix, разделенных запятыми.

Не используйте этот параметр с параметром ConnectionId.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online