Connect-SPOService

Модуль:: Microsoft.Online.SharePoint.PowerShell

Применяется к:: SharePoint Online

Подключает администратора SharePoint Online или администратора SharePoint Embedded к подключению SharePoint Online (Центр администрирования SharePoint Online). Этот командлет необходимо выполнить перед выполнением любых других командлетов SharePoint Online.

Синтаксис

Connect-SPOService
       [-Url] <UrlCmdletPipeBind>
       [[-Credential] <CredentialCmdletPipeBind>]
       [[-ClientTag] <String>]
       [-AuthenticationUrl] <String>
       [[-ModernAuth] <Boolean>]
       [[-UseSystemBrowser] <Boolean>]
       [<CommonParameters>]

Connect-SPOService
       [-Url] <UrlCmdletPipeBind>
       [[-Credential] <CredentialCmdletPipeBind>]
       [[-ClientTag] <String>]
       [[-Region] <AADCrossTenantAuthenticationLocation>]
       [[-ModernAuth] <Boolean>]
       [[-UseSystemBrowser] <Boolean>]
       [<CommonParameters>]

Описание

Командлет Connect-SPOService подключает администратора SharePoint Online или администратора SharePoint Embedded к Центру администрирования SharePoint Online.

Из любого сеанса Windows PowerShell поддерживается только одно подключение к службе SharePoint Online. Другими словами, это отдельный регион в пределах подключения администратора организации. Выполнение командлета Connect-SPOService дважды неявно отключает предыдущее подключение. Сеанс Windows PowerShell будет настроен для обслуживания нового указанного администратора SharePoint Online.

Делегированный администратор партнера должен переключать подключения для разных организаций в рамках одного Windows PowerShell сеанса.

Для выполнения командлета необходимо быть администратором SharePoint Online или администратором SharePoint Embedded.

Сведения о разрешениях и самую последнюю информацию о Windows PowerShell для SharePoint Online см. в электронной документации Знакомство с командной консолью SharePoint Online.

Примеры

-----------------------ПРИМЕР 1-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com -credential [email protected]

В примере 1 показано, как администратор SharePoint Online с учетными данными [email protected] подключается к Центру администрирования SharePoint Online с URL-адресом <https://contoso-admin.sharepoint.com.>

-----------------------ПРИМЕР 2-----------------------------

$username = "[email protected]"
$password = "password"
$cred = New-Object -TypeName System.Management.Automation.PSCredential -argumentlist $userName, $(convertto-securestring $Password -asplaintext -force)
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential $cred

В примере 2 показано, как администратор SharePoint Online с именем пользователя и паролем подключается к Центру администрирования SharePoint Online с URL-адресом. <https://contoso-admin.sharepoint.com.>

-------------------- ---EXAMPLE 3-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com

Запросы учетных данных. Это необходимо, если учетная запись использует многофакторную проверку подлинности.

-----------------------ПРИМЕР 4-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com -Region ITAR

Подключается к Центру администрирования SharePoint Online, указывая регион.

-----------------------ПРИМЕР 5-----------------------------

Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations

Подключение к службе SPO с помощью флага ModernAuth.

-----------------------ПРИМЕР 6-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com -UseSystemBrowser $true

Выполняет проверку подлинности с помощью библиотеки проверки подлинности Майкрософт (MSAL) и подключается к Центру администрирования SharePoint Online при успешной проверке подлинности.

Параметры

-AuthenticationUrl

Расположение для Microsoft Entra службы межтенантной проверки подлинности. При необходимости можно использовать, если используется служба межтенантной проверки подлинности, не используемая по умолчанию.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	SharePoint Online

-ClientTag

Разрешает добавление тега клиента к существующему тегу клиента. При необходимости используется в HTTP-трафике CSOM для идентификации используемого скрипта или решения.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	SharePoint Online

-Credential

Задает учетные данные для соединения. Если учетные данные не указаны, появится диалоговое окно, где их можно будет ввести. Учетные данные должны быть учетными данными администратора SharePoint Online, который может получить доступ к сайту Центра администрирования SharePoint Online.

Тип:	CredentialCmdletPipeBind
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False
Применяется к:	SharePoint Online

-ModernAuth

Гарантирует, что командлеты администрирования клиента SharePoint Online могут подключаться к службе с помощью современных протоколов TLS.

Чтобы использовать его, необходимо также указать параметр AuthenticationUrl .

Тип:	Boolean
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	SharePoint Online

-Region

Допустимые значения: По умолчанию | ITAR | Германия | Китай

Значение по умолчанию — default.

Примечание. Значение ITAR предназначено только для арендаторов GCC High и DoD.

Тип:	AADCrossTenantAuthenticationLocation
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	SharePoint Online

-Url

Указывает URL-адрес сайта Центра администрирования SharePoint Online.

Тип:	UrlCmdletPipeBind
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False
Применяется к:	SharePoint Online

-UseSystemBrowser

Используется для проверки подлинности пользователя с помощью библиотеки проверки подлинности Майкрософт (MSAL).

Тип:	Boolean
Position:	5
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	SharePoint Online