Connect-IPPSSession

Синтаксис

Connect-IPPSSession
       [[-ConnectionUri] <String>]
       [[-AzureADAuthorizationEndpointUri] <String>]
       [[-DelegatedOrganization] <String>]
       [[-PSSessionOption] <PSSessionOption>]
       [[-Prefix] <String>]
       [[-CommandName] <String[]>]
       [[-FormatTypeName] <String[]>]
       [-BypassMailboxAnchoring]
       [-Credential <PSCredential>]
       [-UserPrincipalName <String>]
       [<CommonParameters>]

Описание

Этот комлет позволяет создавать удаленный сеанс PowerShell в средах PowerShell, связанных с Exchange, кроме Exchange Online PowerShell. Например, центр безопасности & PowerShell или автономный Exchange Online Protection PowerShell (для организаций без почтовых ящиков Exchange Online).

Дополнительные сведения о текущих и прошлых общедоступных версиях модуля EXO V2 см. в заметках о выпуске. Эта тема написана для текущей общедоступных версий. Специально отмечены функции или параметры, доступные только в предварительной версии модуля.

Примеры

Пример 1

$UserCredential = Get-Credential
Connect-IPPSSession -Credential $UserCredential

Этот пример подключается к центру & безопасности PowerShell в организации Microsoft 365.

Первая команда получает учетные данные пользователей и хранит их в переменной $UserCredential.

Вторая команда соединяет текущую сессию PowerShell с помощью учетных данных в $UserCredential, которая не включена в MFA.

После завершения Connect-IPPSSession команда ключ пароля в переменной $UserCredential, и можно запустить командлеты Центра & соответствия требованиям PowerShell.

Пример 2

Connect-IPPSSession -Credential (Get-Credential) -ConnectionUri https://ps.protection.outlook.com/powershell-liveid/

В этом примере подключается к автономным powerShell Exchange Online Protection PowerShell в организации, у нее нет почтовых ящиков Exchange Online.

Параметры

-AzureADAuthorizationEndpointUri

Параметр AzureADAuthorizationEndpointUri указывает конечную точку авторизации Azure AD, которая может выдавать маркеры доступа OAuth2. Поддерживаются следующие среды PowerShell и связанные значения:

  • Центр & безопасности PowerShell в Microsoft 365 или Microsoft 365 GCC. Не используйте этот параметр. Необходимое значение , но это также значение по умолчанию, поэтому вам не нужно https://login.microsoftonline.com/common использовать этот параметр.
  • Центр & безопасности PowerShell в Office 365 Германия: https://login.microsoftonline.de/common
  • Центр & безопасности PowerShell в Microsoft GCC High или Microsoft DoD: https://login.microsoftonline.us/common

Если используется параметр UserPrincipalName, вам не нужно использовать параметр AzureADAuthorizationEndpointUri для MFA или федерационных пользователей в средах, которые обычно этого требуют (UserPrincipalName или AzureADAuthorizationEndpointUri). ОК для использования обоих).

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-BypassMailboxAnchoring

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-CommandName

Параметр CommandName указывает разделенный запятой список команд, которые необходимо импортировать в сеанс. Используйте этот параметр для приложений или скриптов, которые используют определенный набор cmdlets. Уменьшение количества комлетов в сеансе помогает повысить производительность и уменьшить след памяти приложения или скрипта.

Type:String[]
Position:5
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-ConnectionUri

Параметр ConnectionUri указывает конечную точку подключения для удаленного сеанса PowerShell. Поддерживаются следующие среды PowerShell и связанные значения:

  • Центр & безопасности PowerShell в Microsoft 365 или Microsoft 365 GCC. Не используйте этот параметр. Необходимое значение , но это также значение по умолчанию, поэтому вам не нужно https://ps.compliance.protection.outlook.com/powershell-liveid/ использовать этот параметр.
  • Центр & безопасности PowerShell в Office 365 Германия: https://ps.compliance.protection.outlook.de/PowerShell-LiveID
  • Центр & безопасности PowerShell в Microsoft GCC High: https://ps.compliance.protection.office365.us/powershell-liveid/
  • Центр & безопасности PowerShell в Microsoft DoD: https://l5.ps.compliance.protection.office365.us/powershell-liveid/
  • Exchange Online Protection PowerShell в автономных организациях EOP без почтовых ящиков Exchange Online: https://ps.protection.outlook.com/powershell-liveid/
Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-Credential

Параметр Credential указывает имя пользователя и пароль, используемый для подключения к Exchange Online PowerShell. Как правило, этот параметр используется в сценариях, или если требуется указывать различные учетные данные, которые предоставляют необходимые разрешения. Не используйте этот параметр для учетных записей, которые используют многофакторную проверку подлинности (MFA).

Перед запуском Connect-IPPSSession сохранить имя пользователя и пароль в переменной (например, $UserCredential = Get-Credential ). Затем используйте переменное имя $UserCredential () для этого параметра.

После завершения Connect-IPPSSession, ключ пароля в переменной опустеет.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-DelegatedOrganization

Параметр DelegatedOrganization указывает организацию клиентов, которую необходимо управлять (например, contosoelectronics.onmicrosoft.com). Этот параметр работает только в том случае, если клиентская организация согласилась на делегирование управления с помощью программы CSP.

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

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-FormatTypeName

Параметр FormatTypeName указывает формат вывода этого комлета.

Type:String[]
Position:6
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-PSSessionOption

Параметр PSSessionOption указывает параметры сеанса PowerShell, которые необходимо использовать в подключении к Exchange Online. Вывод команды New-PSSessionOption хранится в переменной, например:

$Options = New-PSSessionOption <Settings>

Имя переменной используется в качестве значения для этого параметра (например, $Options ).

Type:PSSessionOption
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-UserPrincipalName

Параметр UserPrincipalName указывает учетную запись, которую необходимо использовать для подключения (например, navin@contoso.onmicrosoft.com). Использование этого параметра позволяет пропустить диалоговое окно имени пользователя в современной подсказке проверки подлинности для учетных данных (вам нужно только ввести пароль).

Если используется параметр UserPrincipalName, вам не нужно использовать параметр AzureADAuthorizationEndpointUri для MFA или федерационных пользователей в средах, которые обычно этого требуют (UserPrincipalName или AzureADAuthorizationEndpointUri). ОК для использования обоих).

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-Префикс

Параметр Prefix указывает псевдоним для добавления существильных в имена старых удаленных комлетов PowerShell (cmdlet with nouns, которые еще не начинаются с EXO). Допустимым значением является текстовая строка без пробелов, и вы не можете использовать значение EXO (этот префикс зарезервирован для командлетов модуля PowerShell V2).

Type:String
Position:4
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

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

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