Connect-IPPSSession
Este cmdlet está disponível somente no módulo do PowerShell do Exchange Online. Para obter mais informações, consulte Sobre o módulo do PowerShell do Exchange Online.
Use o cmdlet Connect-IPPSSession no módulo Exchange Online do PowerShell para se conectar ao PowerShell de Segurança & Conformidade usando autenticação moderna. O cmdlet funciona para contas habilitadas para MFA ou não MFA.
Observação: a versão 3.2.0 ou posterior do módulo dá suporte ao modo API REST para praticamente todos os cmdlets do PowerShell de Segurança & Conformidade (a autenticação Básica no WinRM no computador local não é necessária para o modo API REST). Para obter mais informações, consulte Pré-requisitos para o módulo do PowerShell do Exchange Online.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Connect-IPPSSession
[[-ConnectionUri] <String>]
[[-AzureADAuthorizationEndpointUri] <String>]
[[-DelegatedOrganization] <String>]
[[-PSSessionOption] <PSSessionOption>]
[[-Prefix] <String>]
[[-CommandName] <String[]>]
[[-FormatTypeName] <String[]>]
[-AccessToken <String>]
[-AppId <String>]
[-BypassMailboxAnchoring]
[-Certificate <X509Certificate2>]
[-CertificateFilePath <String>]
[-CertificatePassword <SecureString>]
[-CertificateThumbprint <String>]
[-Credential <PSCredential>]
[-DisableWAM]
[-EnableErrorReporting]
[-EnableSearchOnlySession]
[-EXOModuleBasePath <String>]
[-LogDirectoryPath <String>]
[-LogLevel <LogLevel>]
[-Organization <String>]
[-ShowBanner]
[-UserPrincipalName <String>]
[-UseRPSSession]
[<CommonParameters>]
Description
Para obter instruções detalhadas de conexão, incluindo pré-requisitos, consulte Conectar-se ao PowerShell de Segurança & Conformidade.
Exemplos
Exemplo 1
Connect-IPPSSession -UserPrincipalName michelle@contoso.onmicrosoft.com
Este exemplo se conecta ao PowerShell de Segurança & Conformidade usando a conta especificada e autenticação moderna, com ou sem MFA. Na v3.2.0 ou posterior do módulo, estamos nos conectando no modo API REST, portanto, a autenticação Básica no WinRM não é necessária no computador local.
Exemplo 2
Connect-IPPSSession -UserPrincipalName michelle@contoso.onmicrosoft.com -UseRPSSession
Este exemplo se conecta ao PowerShell de Segurança & Conformidade usando a conta especificada e autenticação moderna, com ou sem MFA. Na v3.2.0 ou posterior do módulo, estamos nos conectando no modo PowerShell remoto, portanto, a autenticação Básica no WinRM é necessária no computador local.
Exemplo 3
Connect-IPPSSession -AppId <%App_id%> -CertificateThumbprint <%Thumbprint string of certificate%> -Organization "contoso.onmicrosoft.com"
Este exemplo se conecta ao PowerShell de Segurança & Conformidade em um cenário de script autônomo usando uma impressão digital de certificado.
Exemplo 4
Connect-IPPSSession -AppId <%App_id%> -Certificate <%X509Certificate2 object%> -Organization "contoso.onmicrosoft.com"
Este exemplo se conecta ao PowerShell de Segurança & Conformidade 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 tempo de execução. Por exemplo, o certificado é armazenado no Azure Key Vault.
Parâmetros
-AccessToken
Aplicável: Exchange Online
Observação: este parâmetro está disponível na versão 3.8.0-Preview1 ou posterior do módulo.
O parâmetro AccessToken especifica o JWT (Token Web JSON) OAuth usado para se conectar ao PowerShell de Segurança e Conformidade.
Dependendo do tipo de token de acesso, você precisa usar esse parâmetro com os parâmetros Organization, DelegatedOrganization ou UserPrincipalName.
Propriedades do parâmetro
| Tipo: | 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 |
-AppId
Aplicável: Exchange Online
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 de aplicativo para scripts autônomos no módulo do PowerShell do Exchange Online.
Propriedades do parâmetro
| Tipo: | 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 |
-AzureADAuthorizationEndpointUri
Aplicável: Exchange Online
O parâmetro AzureADAuthorizationEndpointUri especifica o ponto de extremidade de autorização do Microsoft Entra que pode emitir tokens de acesso OAuth2. Há suporte para os seguintes ambientes do PowerShell e valores relacionados:
- PowerShell de Segurança & Conformidade no Microsoft 365 ou Microsoft 365 GCC: não use esse parâmetro. O valor necessário é
https://login.microsoftonline.com/organizations, mas esse também é o valor padrão, portanto, você não precisa usar esse parâmetro. - PowerShell de Segurança & Conformidade em Office 365 operado pela 21Vianet:
https://login.chinacloudapi.cn/organizations - PowerShell de Segurança & Conformidade no Microsoft GCC High ou Microsoft DoD:
https://login.microsoftonline.us/organizations
O valor URI que termina em /organizations permite apenas contas corporativas ou de estudante. O valor de URI mais antigo que termina em /common ainda funciona, mas pode solicitar que você escolha entre uma conta pessoal e uma conta corporativa ou de estudante. Recomendamos o valor URI /organizations em cenários corporativos onde as contas de consumidor devem ser excluídas.
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).
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-BypassMailboxAnchoring
Aplicável: Exchange Online
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-Certificate
Aplicável: Exchange Online
O parâmetro Certificate especifica o certificado usado para autenticação baseada em certificado (CBA). 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 o CBA, consulte Autenticação somente de aplicativo para scripts autônomos no módulo do PowerShell do Exchange Online.
Propriedades do parâmetro
| Tipo: | X509Certificate2 |
| 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 |
-CertificateFilePath
Aplicável: Exchange Online
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 o CBA, consulte Autenticação somente de aplicativo para scripts autônomos no módulo do PowerShell do Exchange Online.
Propriedades do parâmetro
| Tipo: | 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 |
-CertificatePassword
Aplicável: Exchange Online
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 esse 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).passwordserá solicitado a inserir a senha com segurança ao executar esse comando.
Para obter mais informações sobre o CBA, consulte Autenticação somente de aplicativo para scripts autônomos no módulo do PowerShell do Exchange Online.
Observação: usar um comando ConvertTo-SecureString para armazenar a senha do certificado localmente anula a finalidade de um método de conexão segura 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.
Propriedades do parâmetro
| Tipo: | SecureString |
| 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 |
-CertificateThumbprint
Aplicável: Exchange Online
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 tem suporte apenas no Microsoft Windows.
Para obter mais informações sobre o CBA, consulte Autenticação somente de aplicativo para scripts autônomos no módulo do PowerShell do Exchange Online.
Propriedades do parâmetro
| Tipo: | 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 |
-CommandName
Aplicável: Exchange Online
O parâmetro CommandName especifica a lista separada por 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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 5 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConnectionUri
Aplicável: Exchange Online
O parâmetro ConnectionUri especifica o ponto de extremidade de conexão para a sessão do PowerShell. Há suporte para os seguintes ambientes do PowerShell e valores relacionados:
- PowerShell de Segurança & Conformidade no Microsoft 365 ou Microsoft 365 GCC: não use esse parâmetro. O valor necessário é
https://ps.compliance.protection.outlook.com/powershell-liveid/, mas esse também é o valor padrão, portanto, você não precisa usar esse parâmetro. - PowerShell de Segurança & Conformidade em Office 365 operado pela 21Vianet:
https://ps.compliance.protection.partner.outlook.cn/powershell-liveid - PowerShell de Segurança & Conformidade no Microsoft GCC High:
https://ps.compliance.protection.office365.us/powershell-liveid/ - PowerShell de Segurança & Conformidade no DoD da Microsoft:
https://l5.ps.compliance.protection.office365.us/powershell-liveid/
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Credential
Aplicável: Exchange Online
O parâmetro Credential especifica o nome de usuário e a senha usados para se conectar ao PowerShell do Exchange Online. 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 a MFA (autenticação multifator).
Antes de executar o comando Connect-IPPSSession, 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-IPPSSession é concluído, a chave de senha na variável é esvaziada.
Propriedades do parâmetro
| Tipo: | PSCredential |
| 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 |
-DelegatedOrganization
Aplicável: Exchange Online
O parâmetro DelegatedOrganization especifica a organização do cliente que você deseja gerenciar (por exemplo, contosoelectronics.onmicrosoft.com). Esse parâmetro funcionará somente 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ções:
- Use o domínio .onmicrosoft.com primário da organização delegada para o valor desse parâmetro.
- Você deve usar o parâmetro AzureADAuthorizationEndpointUri com esse parâmetro.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DisableWAM
Aplicável: Exchange Online
Nota: Este parâmetro está disponível na versão do módulo 3.7.2-Preview1 ou posterior.
O comutador DisableWAM desabilita o WAM (Gerenciador de Contas da Web). Não é preciso especificar um valor com essa opção.
Se encontrar problemas relacionados ao WAM durante a entrada, você poderá usar essa opção para desabilitar o WAM.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-EnableErrorReporting
Aplicável: Exchange Online
Observação: este parâmetro está disponível na versão 3.8.1-Preview1 ou posterior do módulo.
A opção EnableErrorReporting especifica se o relatório de erros deve ser habilitado. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-EnableSearchOnlySession
Aplicável: Exchange Online
Observação: este parâmetro está disponível na versão 3.9.0-Preview1 ou posterior do módulo.
O comutador EnableSearchOnlySession especifica se determinadas Descobertas Eletrônicas e cmdlets relacionados devem ser habilitados a outros serviços do Microsoft 365. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-EXOModuleBasePath
Aplicável: Exchange Online
Observação: este parâmetro está disponível na versão 3.9.1-Preview1 ou posterior do módulo.
O parâmetro EXOModuleBasePath especifica a pasta em que a cópia temporária local do módulo do PowerShell do Exchange Online está armazenada. Se o valor contiver espaços, coloque-o entre aspas (").
Connect-ExchangeOnline comandos armazenam uma cópia temporária do módulo Exchange Online localmente no cliente para conectividade de sessão. Por padrão, a cópia temporária do módulo é armazenada na pasta %TMP% (por padrão, C:\Users\<UserName>\AppData\Local\Temp).
Propriedades do parâmetro
| Tipo: | 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 |
-FormatTypeName
Aplicável: Exchange Online
O parâmetro FormatTypeName especifica o formato de saída do cmdlet.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 6 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-LogDirectoryPath
Aplicável: Exchange Online
Observação: este parâmetro está disponível na versão 3.8.1-Preview1 ou posterior do módulo.
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 contenha espaços, coloque o valor entre aspas (").
Propriedades do parâmetro
| Tipo: | 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 |
-LogLevel
Aplicável: Exchange Online
Observação: este parâmetro está disponível na versão 3.8.1-Preview1 ou posterior do módulo.
O parâmetro LogLevel especifica o nível de log. Os valores válidos são Padrão e Todos.
Propriedades do parâmetro
| Tipo: | LogLevel |
| 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 |
-Organization
Aplicável: Exchange Online
O parâmetro Organization especifica a organização quando você se conecta usando o CBA. 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 o CBA, consulte Autenticação somente de aplicativo para scripts autônomos no módulo do PowerShell do Exchange Online.
Propriedades do parâmetro
| Tipo: | 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 |
-Prefix
Aplicável: Exchange Online
O parâmetro Prefix especifica um valor de texto a ser adicionado aos nomes dos cmdlets do PowerShell de Segurança & Conformidade quando você se conecta. Por exemplo, Get-ComplianceCase se torna Get-ContosoComplianceCase quando você usa o valor Contoso para esse parâmetro.
- O valor do Prefixo não pode conter espaços ou caracteres especiais, como sublinhados ou asteriscos.
- Não é possível usar o valor de prefixo EXO. Esse valor é reservado para os nove cmdlets exclusivos Get-EXO* integrados ao módulo.
- O parâmetro Prefix afeta apenas nomes de cmdlet de Segurança & Conformidade importados. Isso não afeta os nomes dos cmdlets internos do módulo (por exemplo, Disconnect-ExchangeOnline).
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 4 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PSSessionOption
Aplicável: Exchange Online
Observação: esse parâmetro não funciona em conexões da API REST.
O parâmetro PSSessionOption especifica as opções de sessão remota do PowerShell a serem usadas em sua conexão com o PowerShell de Segurança & Conformidade. 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 esse parâmetro (por exemplo, $PSOptions).
Propriedades do parâmetro
| Tipo: | PSSessionOption |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ShowBanner
Aplicável: Exchange Online
Nota: Este parâmetro está disponível na versão 3.2.0 ou posterior do módulo.
O comutador ShowBanner mostra ou oculta a mensagem de faixa exibida quando você executa Connect-IPPSSession. 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 a faixa, use exatamente esta sintaxe:
-ShowBanner:$false.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-UserPrincipalName
Aplicável: Exchange Online
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 ignorar 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).
Propriedades do parâmetro
| Tipo: | 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 |
-UseRPSSession
Aplicável: Exchange Online
Observação: Este parâmetro está obsoleto na versão 3.9.2 ou posterior do módulo. As conexões remotas do PowerShell com o PowerShell de Segurança & Conformidade foram preteridas em outubro de 2023. Para obter mais informações, consulte Substituição do PowerShell Remoto no PowerShell de Segurança e Conformidade.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| 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 |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.