Connect-SPOService

  • Ссылка
Модуль:
Microsoft.Online.SharePoint.PowerShell
Применяется к:
SharePoint Online

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

Синтаксис

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

Описание

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

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

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

Для запуска этого командлета требуются права администратора SharePoint Online или глобального администратора.

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

Примеры

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

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

В примере 1 показано, как администратор SharePoint Online или глобальный администратор с учетными данными admin@contoso.com подключается к Центру администрирования SharePoint Online с URL-адресом https://contoso-admin.sharepoint.com.

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

$username = "admin@contoso.sharepoint.com"
$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.

-----------------------ПРИМЕР 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.

Параметры

-AuthenticationUrl

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-ClientTag

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Credential

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

Type:CredentialCmdletPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online

-ModernAuth

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

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

Type:Boolean
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Region

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

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

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

Type:AADCrossTenantAuthenticationLocation
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Url

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

Type:UrlCmdletPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online