Compartilhar via

Connect-SPOService

Módulo:
Microsoft.Online.SharePoint.PowerShell Module

Liga o Administrador do SharePoint Online ou o Administrador Incorporado do SharePoint a uma ligação do SharePoint Online (o Centro de Administração do SharePoint Online). Este cmdlet tem de ser executado antes de qualquer outro cmdlet do SharePoint Online poder ser executado.

Sintaxe

AuthenticationCertificate 

Connect-SPOService
    -Url <UrlCmdletPipeBind>
    -ClientId <String>
    -TenantId <String>
    [-ClientTag <String>]
    [-Region <AADCrossTenantAuthenticationLocation>]
    [-AuthenticationUrl <String>]
    [-Certificate <X509Certificate2>]
    [-CertificatePath <String>]
    [-CertificateThumbprint <String>]
    [-CertificatePassword <SecureString>]
    [<CommonParameters>]

AuthenticationLocation 

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

AuthenticationUrl 

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

Description

O Connect-SPOService cmdlet liga o Administrador do SharePoint Online ou o Administrador Incorporado do SharePoint ao Centro de Administração do SharePoint Online.

Apenas uma única ligação de serviço do SharePoint Online é mantida a partir de qualquer sessão de Windows PowerShell. Por outras palavras, trata-se de uma ligação de administrador por área geográfica numa organização. Executar o Connect-SPOService cmdlet duas vezes desliga implicitamente a ligação anterior. A sessão Windows PowerShell será definida para servir o novo administrador do SharePoint Online especificado.

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

Tem de ser administrador do SharePoint Online ou Administrador do SharePoint Embedded 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

Exemplo 1 mostra como um administrador do SharePoint Online com credenciais admin@contoso.com se liga a um Centro de Administração do SharePoint Online que tem o 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

Exemplo 2 mostra como um administrador do SharePoint Online com um nome de utilizador e palavra-passe se liga a um Centro de Administração do SharePoint Online que tem o URL <https://contoso-admin.sharepoint.com.>

EXEMPLO 3

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

Prompts para credenciais. Isto é necessário se a conta estiver a utilizar a autenticação multifator.

EXEMPLO 4

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

Liga-se a um Centro de Administração do SharePoint Online que especifica a região.

EXEMPLO 5

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

Ligar ao Serviço SPO com o Sinalizador ModernAuth.

EXEMPLO 6

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

Autentica-se com a Biblioteca de Autenticação da Microsoft (MSAL) e liga-se ao Centro de Administração do SharePoint Online na autenticação bem-sucedida.

EXEMPLO 7

$password = Read-Host -Prompt "Enter certificate password" -AsSecureString
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -CertificatePath C:\Certs\ContosoAppAuth.pfx -CertificatePassword $password

Ligue-se ao serviço SharePoint Online com uma identidade de aplicação e um caminho de ficheiro de certificado, com uma palavra-passe opcional.

EXEMPLO 8

Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -CertificateThumbprint "3FAAAA1111AAAAAAAAAAA2222AAAAAAAAAAAAAAA"

Ligue-se ao serviço SharePoint Online com uma identidade de aplicação e um thumbprint de certificado.

EXEMPLO 9

$thumbprint = "3F2A5C9D4E7B8A1234567890ABCDEF1234567890"
$cert = Get-ChildItem Cert:\LocalMachine\My\$thumbprint
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -Certificate $cert

Ligue-se ao serviço SharePoint Online com uma identidade de aplicação e um objeto de certificado.

Parâmetros

-AuthenticationUrl

Aplicável: SharePoint Online

Localização para Microsoft Entra serviço de Autenticação Entre Inquilinos. Opcionalmente, pode ser utilizado se for utilizado um Serviço de Autenticação Entre Inquilinos não predefinido.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AuthenticationUrl
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Certificate

Aplicável: SharePoint Online

Um certificado X.509 utilizado durante a autenticação.

Propriedades do parâmetro

Tipo:X509Certificate2
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AuthenticationCertificate
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CertificatePassword

Aplicável: SharePoint Online

A palavra-passe do ficheiro de certificado.

Propriedades do parâmetro

Tipo:SecureString
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AuthenticationCertificate
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CertificatePath

Aplicável: SharePoint Online

O caminho para o ficheiro de certificado .pfx local.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AuthenticationCertificate
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CertificateThumbprint

Aplicável: SharePoint Online

O thumbprint do certificado no arquivo de certificados do utilizador atual.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AuthenticationCertificate
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ClientId

Aplicável: SharePoint Online

O ID de cliente da aplicação.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ApplicationId

Conjuntos de parâmetros

AuthenticationCertificate
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ClientTag

Aplicável: SharePoint Online

Permite acrescentar uma etiqueta de cliente à etiqueta de cliente existente. Utilizado opcionalmente no tráfego http CSOM para identificar o script ou solução utilizado.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Credential

Aplicável: SharePoint Online

Especifica as credenciais a usar para conectar. Caso nenhuma credencial seja apresentada, um diálogo solicitará as credenciais. As credenciais têm de ser de um administrador do SharePoint Online que possa aceder ao site do Centro de Administração do SharePoint Online.

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.PowerShell.CredentialCmdletPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AuthenticationUrl
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
AuthenticationLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ModernAuth

Aplicável: SharePoint Online

Garante que os cmdlets de administração de inquilinos do SharePoint Online se podem ligar ao serviço através de protocolos TLS modernos.

Para utilizá-lo, também tem de fornecer o parâmetro AuthenticationUrl .

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AuthenticationUrl
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
AuthenticationLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Region

Aplicável: SharePoint Online

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

O valor predefinido é "predefinição".

Nota: o valor ITAR destina-se apenas a inquilinos GCC High e DoD.

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.PowerShell.AADCrossTenantAuthenticationLocation
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AuthenticationLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
AuthenticationCertificate
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TenantId

Aplicável: SharePoint Online

O ID do inquilino ao qual ligar.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AuthenticationCertificate
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Url

Aplicável: SharePoint Online

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

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.PowerShell.UrlCmdletPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UseSystemBrowser

Aplicável: SharePoint Online

Utilizado para autenticar o utilizador com a Biblioteca de Autenticação da Microsoft (MSAL).

Observação

Para evitar adicionar o -UseSystemBrowser parâmetro sempre que executar Connect-SPOService, pode definir uma chave de registo como alternativa.

Defina a chave do UseSystemBrowser registo (tipo REG_DWORD) em: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SPO\CMDLETS\

Se uma das chaves de registo estiver definida para um valor inteiro diferente de zero ou -UseSystemBrowser o parâmetro estiver definido como true, o fluxo de autenticação utilizará o browser do sistema para iniciar sessão.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AuthenticationUrl
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
AuthenticationLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.