Compartilhar via


Connect-ExchangeOnline

Esse cmdlet está disponível apenas no módulo Exchange Online PowerShell. Para obter mais informações, consulte Sobre o módulo Exchange Online PowerShell.

Use o cmdlet Connect-ExchangeOnline no módulo Exchange Online PowerShell para se conectar ao Exchange Online PowerShell ou Proteção do Exchange Online autônomo do PowerShell usando a autenticação moderna. Esse cmdlet funciona para contas com ou sem MFA (autenticação multifator).

Para se conectar ao PowerShell de Conformidade de Segurança & , use o cmdlet Connect-IPPSSession .

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Connect-ExchangeOnline
       [[-ConnectionUri] <String>]
       [[-AzureADAuthorizationEndpointUri] <String>]
       [[-ExchangeEnvironmentName] <ExchangeEnvironment>]
       [[-PSSessionOption] <PSSessionOption>]
       [[-DelegatedOrganization] <String>]
       [[-Prefix] <String>]
       [[-CommandName] <String[]>]
       [[-FormatTypeName] <String[]>]
       [-AccessToken <String>]
       [-AppId <String>]
       [-BypassMailboxAnchoring]
       [-Certificate <X509Certificate2>]
       [-CertificateFilePath <String>]
       [-CertificatePassword <SecureString>]
       [-CertificateThumbprint <String>]
       [-Credential <PSCredential>]
       [-Device]
       [-EnableErrorReporting]
       [-InlineCredential]
       [-LogDirectoryPath <String>]
       [-LogLevel <LogLevel>]
       [-ManagedIdentity]
       [-ManagedIdentityAccountId <String>]
       [-Organization <String>]
       [-PageSize <UInt32>]
       [-ShowBanner]
       [-ShowProgress <Boolean>]
       [-SigningCertificate <X509Certificate2>]
       [-SkipLoadingFormatData]
       [-TrackPerformance <Boolean>]
       [-UseMultithreading <Boolean>]
       [-UserPrincipalName <String>]
       [-UseRPSSession]
       [<CommonParameters>]

Description

Esse cmdlet cria uma conexão do PowerShell com sua organização Exchange Online. Você pode usar esse cmdlet para autenticar para cmdlets apoiados pela API REST no módulo Exchange Online PowerShell V3 e também para todos os cmdlets existentes Exchange Online PowerShell (cmdlets remotos do PowerShell).

Os comandos connect provavelmente falharão se o caminho de perfil da conta que você usou para se conectar contiver caracteres especiais do PowerShell (por exemplo, $). A solução alternativa é conectar-se usando uma conta diferente que não tenha caracteres especiais no caminho do perfil.

Exemplos

Exemplo 1

Connect-ExchangeOnline -UserPrincipalName chris@contoso.com

Este exemplo se conecta ao Exchange Online PowerShell usando a autenticação moderna, com ou sem MFA (autenticação multifator). Não estamos usando o comutador UseRPSSession, portanto, a conexão usa REST e não exige que a autenticação básica seja habilitada no WinRM no computador local.

Exemplo 2

Connect-ExchangeOnline -UserPrincipalName chris@contoso.com -UseRPSSession

Este exemplo se conecta ao Exchange Online PowerShell usando a autenticação moderna, com ou sem MFA. Estamos usando o comutador UseRPSSession, portanto, a conexão requer que a autenticação básica seja habilitada no WinRM no computador local.

Exemplo 3

Connect-ExchangeOnline -AppId <%App_id%> -CertificateThumbprint <%Thumbprint string of certificate%> -Organization "contoso.onmicrosoft.com"

Este exemplo se conecta a Exchange Online PowerShell em um cenário de script autônomo usando uma impressão digital de certificado.

Exemplo 4

Connect-ExchangeOnline -AppId <%App_id%> -Certificate <%X509Certificate2 object%> -Organization "contoso.onmicrosoft.com"

Este exemplo se conecta ao Exchange Online PowerShell em um cenário de script autônomo usando um arquivo de certificado. Esse método é mais adequado para cenários em que o certificado é armazenado em computadores remotos e buscado em runtime. Por exemplo, o certificado é armazenado no Key Vault do Azure.

Exemplo 5

Connect-ExchangeOnline -Device

No PowerShell 7.0.3 ou posterior usando a versão 2.0.4 ou posterior do módulo, este exemplo se conecta ao Exchange Online PowerShell em cenários interativos de script em computadores que não têm navegadores da Web.

O comando retorna um URL e um código exclusivo vinculado à sessão. Você precisa abrir o URL em um navegador em qualquer computador e, em seguida, inserir o código exclusivo. Depois de concluir o logon no navegador da Web, a sessão na janela do Windows PowerShell 7 é autenticada por meio do fluxo de autenticação regular do Azure Active Directory e os cmdlets do Exchange Online são importados após alguns segundos.

Exemplo 6

Connect-ExchangeOnline -InlineCredential

No PowerShell 7.0.3 ou posterior usando a versão 2.0.4 ou posterior do módulo, este exemplo se conecta ao Exchange Online PowerShell em cenários interativos de script passando credenciais diretamente na janela do PowerShell.

Parâmetros

-AccessToken

Observação: esse parâmetro está disponível na versão 3.1.0 ou posterior do módulo.

O parâmetro AccessToken especifica o JWT (OAuth JSON Web Token) usado para se conectar ao ExchangeOnline.

Dependendo do tipo de token de acesso, você precisa usar esse parâmetro com o parâmetro Organization, DelegatedOrganization ou UserPrincipalName.

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

-AppId

O parâmetro AppId especifica a ID do aplicativo da entidade de serviço usada na CBA (autenticação baseada em certificado). Um valor válido é o GUID da ID do aplicativo (entidade de serviço). Por exemplo, 36ee4c6c-0812-40a2-b820-b22ebd02bce3.

Para obter mais informações, consulte Autenticação somente aplicativo para scripts autônomos no módulo Exchange Online PowerShell.

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

-AzureADAuthorizationEndpointUri

Observação: se você usar o parâmetro ExchangeEnvironmentName, não precisará usar os parâmetros AzureADAuthorizationEndpointUri ou ConnectionUri.

O parâmetro AzureADAuthorizationEndpointUri especifica o ponto de extremidade Azure AD Autorização que pode emitir tokens de acesso OAuth2. Há suporte para os seguintes Exchange Online ambientes e valores relacionados do PowerShell:

  • Microsoft 365 ou Microsoft 365 GCC: não use esse parâmetro. O valor necessário é https://login.microsoftonline.com/common, mas esse também é o valor padrão, portanto, você não precisa usar esse parâmetro.
  • Office 365 Alemanha:https://login.microsoftonline.de/common
  • Microsoft 365 GCC High ou Microsoft 365 DoD: https://login.microsoftonline.us/common

Se você usar o parâmetro UserPrincipalName, não precisará usar o parâmetro AzureADAuthorizationEndpointUri para MFA ou usuários federados em ambientes que normalmente o exigem (UserPrincipalName ou AzureADAuthorizationEndpointUri é necessário; OK para usar ambos).

Observação: a autenticação MFA ou a autenticação federada não está disponível no Office 365 operado pela 21Vianet.

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

-BypassMailboxAnchoring

A opção BypassMailboxAnchoring ignora o uso da dica de ancoragem da caixa de correio. Não é preciso especificar um valor com essa opção.

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

-Certificate

O parâmetro Certificado especifica o certificado usado para a CBA (autenticação baseada em certificado). Um valor válido é o valor do objeto X509Certificate2 do certificado.

Não use esse parâmetro com os parâmetros CertificateFilePath ou CertificateThumbprint.

Para obter mais informações sobre a CBA, consulte Autenticação somente aplicativo para scripts autônomos no módulo Exchange Online PowerShell.

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

-CertificateFilePath

O parâmetro CertificateFilePath especifica o certificado usado para CBA. Um valor válido é o caminho público completo para o arquivo de certificado. Use o parâmetro CertificatePassword com esse parâmetro.

Não use esse parâmetro com os parâmetros Certificate ou CertificateThumbprint.

Para obter mais informações sobre a CBA, consulte Autenticação somente aplicativo para scripts autônomos no módulo Exchange Online PowerShell.

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

-CertificatePassword

O parâmetro CertificatePassword especifica a senha necessária para abrir o arquivo de certificado quando você usa o parâmetro CertificateFilePath para identificar o certificado usado para CBA.

Você pode usar os seguintes métodos como um valor para este parâmetro:

  • (ConvertTo-SecureString -String '<password>' -AsPlainText -Force).
  • Antes de executar esse comando, armazene a senha como uma variável (por exemplo, $password = Read-Host "Enter password" -AsSecureString), e use a variável ($password) para o valor.
  • (Get-Credential).password a ser solicitado a inserir a senha com segurança ao executar esse comando.

Para obter mais informações sobre a CBA, consulte Autenticação somente aplicativo para scripts autônomos no módulo Exchange Online PowerShell.

Observação: usar um comando ConvertTo-SecureString para armazenar a senha do certificado localmente derrota a finalidade de um método de conexão seguro para cenários de automação. Usar um comando Get-Credential para solicitar a senha do certificado com segurança não é ideal para cenários de automação. Em outras palavras, não há realmente nenhuma maneira automatizada e segura de se conectar usando um certificado local.

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

-CertificateThumbprint

O parâmetro CertificateThumbprint especifica o certificado usado para CBA. Um valor válido é o valor da impressão digital do certificado. Por exemplo, 83213AEAC56D61C97AEE5C1528F4AC5EBA7321C1.

Não use esse parâmetro com os parâmetros Certificate ou CertificateFilePath.

Observação: o parâmetro CertificateThumbprint só tem suporte no Microsoft Windows.

Para obter mais informações sobre a CBA, consulte Autenticação somente aplicativo para scripts autônomos no módulo Exchange Online PowerShell.

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

-CommandName

O parâmetro CommandName especifica a lista separada de vírgulas de comandos a serem importados para a sessão. Use esse parâmetro para aplicativos ou scripts que usam um conjunto específico de cmdlets. Reduzir o número de cmdlets na sessão ajuda a melhorar o desempenho e reduz o volume de memória do aplicativo ou script.

Type:String[]
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ConnectionUri

Observação: se você usar o parâmetro ExchangeEnvironmentName, não precisará usar os parâmetros AzureADAuthorizationEndpointUri ou ConnectionUri.

O parâmetro ConnectionUri especifica o ponto de extremidade de conexão para a sessão remota Exchange Online PowerShell. Há suporte para os seguintes Exchange Online ambientes e valores relacionados do PowerShell:

  • Microsoft 365 ou Microsoft 365 GCC: não use esse parâmetro. O valor necessário é https://outlook.office365.com/powershell-liveid/, mas esse também é o valor padrão, portanto, você não precisa usar esse parâmetro.
  • Office 365 Alemanha:https://outlook.office.de/PowerShell-LiveID
  • Office 365 operado pela 21Vianet:https://partner.outlook.cn/PowerShell
  • Microsoft 365 GCC High: https://outlook.office365.us/powershell-liveID
  • Microsoft 365 DoD: https://webmail.apps.mil/powershell-liveID
Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Credential

O parâmetro Credential especifica o nome de usuário e a senha usados para se conectar ao Exchange Online PowerShell. Normalmente, você usa esse parâmetro em scripts ou quando você precisa fornecer credenciais diferentes que têm as permissões necessárias. Não use esse parâmetro para contas que usam MFA (autenticação multifator).

Antes de executar o comando Connect-ExchangeOnline, armazene o nome de usuário e a senha em uma variável (por exemplo, $UserCredential = Get-Credential). Em seguida, use o nome da variável ($UserCredential) para esse parâmetro.

Depois que o comando Connect-ExchangeOnline for concluído, a chave de senha na variável será esvaziada.

Para especificar a senha de um arquivo de certificado, não use esse parâmetro; em vez disso, use o parâmetro CertificatePassword.

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

-DelegatedOrganization

O parâmetro DelegatedOrganization especifica a organização do cliente que você deseja gerenciar (por exemplo, contosoelectronics.onmicrosoft.com). Esse parâmetro só funcionará se a organização do cliente tiver concordado com o gerenciamento delegado por meio do programa CSP.

Depois de autenticar com êxito, os cmdlets nesta sessão são mapeados para a organização do cliente e todas as operações nesta sessão são feitas na organização do cliente.

Observação: use o domínio .onmicrosoft.com primário da organização delegada para o valor desse parâmetro.

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

-Device

Observação: esse parâmetro está disponível na versão 2.0.4 ou posterior do módulo e somente no PowerShell 7.

Normalmente, a opção Dispositivo é usada em computadores sem navegadores da Web. Não é preciso especificar um valor com essa opção.

O uso dessa opção resulta em uma mensagem na tela que contém a URL https://microsoft.com/devicelogin e um código exclusivo. Em qualquer outro dispositivo com um navegador da Web e acesso à Internet, abra a URL, insira o código exclusivo e insira suas credenciais nas páginas subsequentes.

Se o logon tiver sido bem-sucedido, a conexão do PowerShell continuará.

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

-EnableErrorReporting

A opção EnableErrorReporting especifica se é possível habilitar o relatório de erros. Não é preciso especificar um valor com essa opção.

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

-ExchangeEnvironmentName

O ExchangeEnvironmentName especifica o ambiente Exchange Online e elimina a necessidade de usar os parâmetros AzureADAuthorizationEndpointUri e ConnectionUri. Há suporte para os seguintes Exchange Online ambientes do PowerShell:

  • Microsoft 365 ou Microsoft 365 GCC: não use esse parâmetro. O valor necessário é O365Default, mas esse também é o valor padrão, portanto, você não precisa usar esse parâmetro.
  • Office 365 Alemanha:O365GermanyCloud
  • Office 365 operado pela 21Vianet:O365China
  • Microsoft 365 GCC High: O365USGovGCCHigh
  • Microsoft 365 DoD: O365USGovDoD
Type:ExchangeEnvironment
Position:2
Default value:O365Default
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-FormatTypeName

O parâmetro FormatTypeName especifica o formato de saída do cmdlet.

Type:String[]
Position:7
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-InlineCredential

Observação: esse parâmetro está disponível na versão 2.0.4 ou posterior do módulo e somente no PowerShell 7.

A opção InlineCredential especifica se deve passar credenciais diretamente na janela Windows PowerShell. Não é preciso especificar um valor com essa opção.

Essa opção é semelhante ao parâmetro Credential, mas com segurança adicional. A opção InlineCredential não exige que você armazene as credenciais localmente no script e você pode inserir credenciais diretamente em uma sessão interativa do PowerShell.

Essa opção não funciona com contas que usam MFA.

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

-LogDirectoryPath

O parâmetro LogDirectoryPath especifica o local dos arquivos de log. O local padrão é %TMP%\EXOCmdletTelemetry\EXOCmdletTelemetry-yyyymmdd-hhmmss.csv.

Se você especificar um local personalizado e um nome de arquivo que contém espaços, inclua o valor entre aspas (").

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

-LogLevel

O parâmetro LogLevel especifica o nível de log. Os valores válidos são Padrão e Todos.

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

-ManagedIdentity

A opção ManagedIdentity especifica que você está usando a identidade gerenciada para se conectar. Não é preciso especificar um valor com essa opção.

Atualmente, há suporte para conexões de identidade gerenciadas para os seguintes tipos de recursos do Azure:

  • Automação do Azure runbooks
  • Máquinas Virtuais do Azure
  • Conjuntos de Dimensionamento de Máquinas Virtuais do Azure
  • Azure Functions

Você deve usar essa opção com o parâmetro Organização.

Para a identidade gerenciada atribuída pelo usuário, você também deve usar essa opção com o parâmetro ManagedIdentityAccountId.

Para obter mais informações sobre como se conectar à identidade gerenciada, consulte Usar identidades gerenciadas do Azure para se conectar ao Exchange Online PowerShell.

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

-ManagedIdentityAccountId

O parâmetro ManagedIdentityAccountId especifica a identidade gerenciada atribuída pelo usuário que você está usando para se conectar. Um valor válido para esse parâmetro é a ID do aplicativo (GUID) da entidade de serviço que corresponde à identidade gerenciada atribuída pelo usuário no Azure.

Você deve usar esse parâmetro com o parâmetro Organization e a opção ManagedIdentity.

Para obter mais informações sobre como se conectar à identidade gerenciada, consulte Usar identidades gerenciadas do Azure para se conectar ao Exchange Online PowerShell.

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

-Organization

O parâmetro Organização especifica a organização quando você se conecta usando a CBA ou a identidade gerenciada. Você deve usar o domínio .onmicrosoft.com primário da organização para o valor desse parâmetro.

Para obter mais informações sobre como se conectar com a CBA, confira Autenticação somente aplicativo para scripts autônomos no módulo Exchange Online PowerShell.

Para obter mais informações sobre como se conectar à identidade gerenciada, consulte Usar identidades gerenciadas do Azure para se conectar ao Exchange Online PowerShell.

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

-PageSize

O parâmetro PageSize especifica o número máximo de entradas por página. A entrada válida para este parâmetro é um número inteiro entre 1 e 1000. O valor padrão é 1000.

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

-Prefix

O parâmetro Prefix especifica um valor de texto a ser adicionado aos nomes de Exchange Online cmdlets do PowerShell quando você se conecta. Por exemplo, Get-InboundConnector se torna Get-ContosoInboundConnector quando você usa o valor Contoso para este parâmetro.

  • O valor prefixo não pode conter espaços ou caracteres especiais, como sublinhados ou asteriscos.
  • Você não pode usar o EXO do valor de prefixo. Esse valor é reservado para os nove cmdlets get-EXO* exclusivos que são incorporados ao módulo.
  • O parâmetro Prefix afeta apenas nomes de cmdlet Exchange Online importados. Isso não afeta os nomes de cmdlets que são incorporados ao módulo (por exemplo, Disconnect-ExchangeOnline).
Type:String
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PSSessionOption

O parâmetro PSSessionOption especifica as opções de sessão do PowerShell a serem usadas em sua conexão com Exchange Online. Esse parâmetro só funcionará se você também usar a opção UseRPSSession no mesmo comando.

Armazene a saída do comando New-PSSessionOption em uma variável (por exemplo, $PSOptions = New-PSSessionOption <Settings>), e use o nome da variável como o valor para este parâmetro (por exemplo, $PSOptions).

Type:PSSessionOption
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShowBanner

A opção ShowBanner mostra ou oculta a mensagem de banner exibida quando você executa o Connect-ExchangeOnline. Não é preciso especificar um valor com essa opção.

  • Para mostrar a faixa, você não precisa usar essa opção (a faixa é exibida por padrão).
  • Para ocultar o banner, use esta sintaxe exata: -ShowBanner:$false.
Type:SwitchParameter
Position:Named
Default value:$true
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShowProgress

O parâmetro ShowProgress especifica se você deve mostrar ou ocultar a barra de progresso de cmdlets importados ao se conectar. Os valores válidos são:

  • $true: a barra de progresso é exibida. Esse é o valor padrão.
  • $false: atualmente, esse valor não tem efeito.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SigningCertificate

Observação: esse parâmetro está disponível na versão 3.2.0 ou posterior do módulo.

O parâmetro SigningCertificate especifica o certificado cliente usado para assinar os arquivos de formato (*. Format.ps1xml) ou arquivos de módulo de script (.psm1) no módulo temporário que Connect-ExchangeOnline cria.

Um valor válido para esse parâmetro é uma variável que contém o certificado ou um comando ou expressão que obtém o certificado.

Para localizar o certificado, use o cmdlet Get-PfxCertificate no módulo Microsoft.PowerShell.Security ou use o cmdlet Get-ChildItem no certificado (Cert:) Dirigir. Se o certificado não for válido ou não tiver autoridade suficiente, o comando falhará.

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

-SkipLoadingFormatData

A opção SkipLoadingFormatData evita baixar os dados de formato para conexões de API REST. Não é preciso especificar um valor com essa opção.

Quando você usar essa opção, a saída de qualquer cmdlet do Exchange será desformada.

Essa opção não funciona com a opção UseRPSSession.

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

-TrackPerformance

O parâmetro TrackPerformance mede eventos adicionais (por exemplo, carga de CPU e memória consumidas). Os valores válidos são:

  • $true: o controle de desempenho está habilitado.
  • $false: o controle de desempenho está desabilitado. Esse é o valor padrão.

Esse parâmetro só funciona quando o registro em log é habilitado.

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

-UseMultithreading

O parâmetro UseMultithreading especifica se deve desabilitar ou habilitar o multi-threading no módulo Exchange Online PowerShell. Os valores válidos são:

  • $true: habilitar o multi threading. Esse é o valor padrão.
  • $false: Desabilitar vários threads. Esse valor degradará o desempenho dos nove cmdlets Get-EXO* exclusivos no módulo.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UserPrincipalName

O parâmetro UserPrincipalName especifica a conta que você deseja usar para se conectar (por exemplo, navin@contoso.onmicrosoft.com). O uso desse parâmetro permite que você ignore a inserção de um nome de usuário no prompt de credenciais de autenticação moderna (você é solicitado a inserir uma senha).

Se você usar o parâmetro UserPrincipalName, não precisará usar o parâmetro AzureADAuthorizationEndpointUri para MFA ou usuários federados em ambientes que normalmente o exigem (UserPrincipalName ou AzureADAuthorizationEndpointUri é necessário; OK para usar ambos).

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

-UseRPSSession

A opção UseRPSSession permite que você se conecte ao Exchange Online PowerShell usando o acesso remoto tradicional do PowerShell a todos os cmdlets. Não é preciso especificar um valor com essa opção.

Essa opção requer que a autenticação básica esteja habilitada no WinRM no computador local. Para obter mais informações, consulte Ativar a autenticação básica no WinRM.

Se você não usar essa opção, a autenticação básica no WinRM não será necessária.

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