Connect-SPOService

참조

모듈:: Microsoft.Online.SharePoint.PowerShell

적용 대상:: SharePoint Online

SharePoint Online 관리자 또는 전역 관리자를 SharePoint Online 연결(SharePoint Online 관리 센터)에 연결합니다. 다른 SharePoint Online cmdlet을 실행하려면 먼저 이 cmdlet을 실행해야 합니다.

Syntax

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

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

Description

이 cmdlet은 Connect-SPOService SharePoint Online 관리자 또는 전역 관리자를 SharePoint Online 관리 센터에 연결합니다.

단일 Windows PowerShell 세션에서 단일 SharePoint Online 서비스 연결만 유지 관리됩니다. 즉, 조직 관리자 연결 내의 지역별 연결입니다. cmdlet을 Connect-SPOService 두 번 실행하면 이전 연결이 암시적으로 끊어집니다. Windows PowerShell 세션은 지정된 새 SharePoint Online 관리자에게 제공되도록 설정됩니다.

위임된 파트너 관리자는 동일한 Windows PowerShell 세션 내의 여러 조직에 대한 연결을 교환해야 합니다.

cmdlet을 실행하려면 SharePoint Online 관리자 또는 전역 관리자 역할이 있어야 합니다.

SharePoint Online용 Windows PowerShell의 사용 권한과 최신 정보는 SharePoint Online 관리 셸 소개의 온라인 설명서를 참조하세요.

예제

-----------------------예제 1-----------------------------

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

예제 1에서는 자격 증명 admin@contoso.com 있는 SharePoint Online 관리자 또는 전역 관리자가 URL이 있는 SharePoint 온라인 관리 센터에 연결하는 방법을 보여 줍니다.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 관리자 또는 전역 관리자가 URL이 있는 SharePoint Online 관리 센터에 연결하는 방법을 보여 줍니다.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 온라인 관리 센터에 연결합니다.

매개 변수

-AuthenticationUrl

AAD 테넌트 간 인증 서비스의 위치입니다. 기본이 아닌 테넌트 간 인증 서비스를 사용하는 경우 필요에 따라 사용할 수 있습니다.

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

-ClientTag

기존 클라이언트 태그에 클라이언트 태그를 추가할 수 있습니다. CSOM http 트래픽에서 필요에 따라 사용된 스크립트 또는 솔루션을 식별하는 데 사용됩니다.

Type:	String
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-Url

SharePoint Online Administration Center 사이트의 URL을 지정합니다.

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

-자격 증명

연결에 사용할 자격 증명을 지정합니다. 자격 증명을 지정하지 않으면 자격 증명을 묻는 대화 상자가 나타납니다. 자격 증명은 SharePoint Online 관리 센터 사이트에 액세스할 수 있는 SharePoint Online 관리자 또는 전역 관리자의 자격 증명이어야 합니다.

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