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 |