Disconnect-ExchangeOnline
Этот командлет доступен только в модуле PowerShell Exchange Online. Дополнительные сведения см. в статье О модуле PowerShell Exchange Online.
Используйте командлет Disconnect-ExchangeOnline в модуле Exchange Online PowerShell, чтобы отключить подключения, созданные с помощью Connect-ExchangeOnline или Connect-IPPSSession командлетов.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
DefaultParameterSet (По умолчанию)
Disconnect-ExchangeOnline
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ConnectionId
Disconnect-ExchangeOnline
-ConnectionId <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ModulePrefix
Disconnect-ExchangeOnline
-ModulePrefix <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Описание
Этот командлет является аналогом командлетов Connect-ExchangeOnline и Connect-IPPSSession.
Этот командлет отключает все подключения и очищает кэш. После успешного отключения вы не сможете успешно запускать командлеты для своей организации.
Команды отключения, скорее всего, не будут работать, если путь к профилю учетной записи, которую вы использовали для подключения, содержит специальные символы PowerShell (например, $). В качестве обходного решения можно подключиться с помощью другой учетной записи, в пути к профилю которой нет специальных символов.
Примеры
Пример 1
Disconnect-ExchangeOnline
В этом примере запрашивается подтверждение перед отключением от Exchange Online PowerShell или Security & Compliance PowerShell.
Пример 2
Disconnect-ExchangeOnline -Confirm:$false
В этом примере автоматически отключается Exchange Online PowerShell или Security & Compliance PowerShell без запроса подтверждения или текста уведомления.
Пример 3
Disconnect-ExchangeOnline -ConnectionId 1a9e45e8-e7ec-498f-9ac3-0504e987fa85
В этом примере отключается подключение PowerShell к Exchange Online на основе REST с указанным значением ConnectionId. Также будут отключены все другие удаленные подключения PowerShell к Exchange Online PowerShell или Security & Compliance PowerShell в том же окне Windows PowerShell.
Пример 4
Disconnect-ExchangeOnline -ModulePrefix Contoso,Fabrikam
В этом примере отключаются подключения PowerShell к Exchange Online на базе REST, которые используют указанные значения префиксов. Также будут отключены все другие удаленные подключения PowerShell к Exchange Online PowerShell или Security & Compliance PowerShell в том же окне Windows PowerShell.
Параметры
-Confirm
Применимо: Exchange Online
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConnectionId
Применимо: Exchange Online
Примечание: Этот параметр доступен в модуле версии 3.2.0-Preview2 или более поздней.
Параметр ConnectionId указывает, какие подключения REST API отключаются по ConnectionId. ConnectionId — это значение GUID в выходных данных командлета Get-ConnectionInformation, которое однозначно идентифицирует подключение, даже если открыто несколько соединений. Вы можете указать несколько значений ConnectionId, разделенных запятыми.
Не используйте этот параметр с параметром ModulePrefix.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ConnectionId
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ModulePrefix
Применимо: Exchange Online
Примечание: Этот параметр доступен в модуле версии 3.2.0-Preview2 или более поздней.
Параметр ModulePrefix указывает, какие подключения REST API нужно отключать по ModulePrefix. При использовании параметра Prefix с командлетом Connect-ExchangeOnline указанный текст добавляется к именам всех командлетов Exchange Online (например, Get-InboundConnector преобразуется в Get-ContosoInboundConnector). Значение ModulePrefix отображается в выводе командлета Get-ConnectionInformation. Вы можете указать несколько значений ModulePrefix, разделенных запятыми.
Не используйте этот параметр с параметром ConnectionId.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ModulePrefix
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Online
Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | 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.