Connect-SPOService

  • Referência
Módulo:
Microsoft.Online.SharePoint.PowerShell
Aplica-se a:
SharePoint Online

Conecta um administrador do SharePoint Online ou administrador global a uma conexão do SharePoint Online (o Centro de Administração do SharePoint Online). Esse cmdlet deve ser executado antes que outros cmdlets do SharePoint Online possam ser executados.

Syntax

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

Description

O Connect-SPOService cmdlet conecta um administrador do SharePoint Online ou administrador global ao Centro de Administração do SharePoint Online.

Apenas uma única conexão de serviço do SharePoint Online é mantida de qualquer sessão de Windows PowerShell. Em outras palavras, isso é um por geográfico dentro de uma conexão de administrador da organização. Executar o Connect-SPOService cmdlet desconecta implicitamente duas vezes a conexão anterior. A sessão Windows PowerShell será definida para atender ao novo administrador do SharePoint Online especificado.

Um administrador de parceiro delegado precisa trocar conexões por organizações diferentes na mesma sessão de Windows PowerShell.

Você deve ser um administrador do SharePoint Online ou Administrador global para executar o cmdlet.

Para obter permissões e as informações mais recentes sobre o Windows PowerShell do SharePoint Online, consulte a documentação on-line em Introdução ao Shell de gerenciamento do SharePoint Online..

Exemplos

-----------------------EXEMPLO 1-----------------------------

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

O exemplo 1 mostra como um administrador do SharePoint Online ou administrador global com credencial admin@contoso.com se conecta a um Centro de Administração do SharePoint Online que tem a URL https://contoso-admin.sharepoint.com.

-----------------------EXEMPLO 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

O exemplo 2 mostra como um administrador do SharePoint Online ou administrador global com um nome de usuário e senha se conecta a um Centro de Administração do SharePoint Online que tem a URL https://contoso-admin.sharepoint.com.

-----------------------EXEMPLO 3-----------------------------

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

Solicitações de credenciais. Isso será necessário se a conta estiver usando autenticação multifator.

-----------------------EXEMPLO 4-----------------------------

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

Conecta-se a um Centro de Administração do SharePoint Online especificando a região.

-----------------------EXEMPLO 5-----------------------------

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

Conectando-se ao Serviço de SPO com o ModernAuth Flag.

Parâmetros

-AuthenticationUrl

Local para o serviço de Autenticação Entre Locatários do AAD. Opcionalmente, pode ser usado se o Serviço de Autenticação Entre Locatários não padrão for usado.

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

-ClientTag

Permite acrescentar uma marca de cliente à marca de cliente existente. Usado opcionalmente no tráfego http do CSOM para identificar script ou solução usada.

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

-Credential

Especifica as credenciais a usar para conectar. Caso nenhuma credencial seja apresentada, um diálogo solicitará as credenciais. As credenciais devem ser as de um administrador do SharePoint Online ou administrador global que pode acessar o site do Centro de Administração do SharePoint Online.

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

-ModernAuth

Garante que os cmdlets de administração de locatários do SharePoint Online possam se conectar ao serviço usando protocolos TLS modernos.

Para usá-lo, você também precisa fornecer o parâmetro AuthenticationUrl .

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

-Region

Os valores válidos são: Padrão | ITAR | Alemanha | China

O valor padrão é "padrão".

Observação: o valor ITAR é apenas para locatários GCC High e DoD.

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

-Url

Especifica a URL do site do Centro de Administração do SharePoint Online.

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