Soluções alternativas para cenários de Invoke-Command em conexões da API REST

Em várias conexões com o PowerShell Exchange Online ou de Segurança & Conformidade na mesma janela, você usa o cmdlet Invoke-Command para executar scripts ou comandos em uma sessão remota específica do PowerShell. Porém, o cmdlet Invoke-Command não funciona em conexões de API REST com o PowerShell Exchange Online ou de Segurança & Conformidade.

Este artigo oferece alternativas de API REST para cenários que usam comandos Invoke-Command .

Cenário 1: Executar cmdlets do Exchange Online

Este exemplo localiza a identidade de qualquer outro usuário ($Us = $User.Identity).

• Em uma sessão remota do PowerShell: Use o cmdlet Get-PSSession para armazenar os detalhes da sessão remota do PowerShell na variável chamada $Sessione execute o seguinte comando:

  Invoke-Command -Session $Session -ScriptBlock {Get-User $Using:Us | Select-Object DistinguishedName, ExternalDirectoryObjectId} -ErrorAction SilentlyContinue
  

• Em uma sessão da API REST: Execute o seguinte comando:

  Get-User $Us | Format-List DistinguishedName, ExternalDirectoryObjectId
  

Este exemplo localiza a identidade de um membro do grupo:

• Em uma sessão remota do PowerShell: Use o cmdlet Get-PSSession para armazenar os detalhes da sessão remota do PowerShell na variável chamada $Sessione execute o seguinte comando:

  Invoke-Command -Session $Session -ScriptBlock {Get-Recipient -Filter "Members -eq '$($User.DistinguishedName)'" -RecipientTypeDetails MailUniversalDistributionGroup | Select-Object DisplayName, ExternalDirectoryObjectId, RecipientTypeDetails} -ErrorAction SilentlyContinue -HideComputerName
  

• Em uma sessão da API REST: Execute o seguinte comando:

  Get-Recipient -Filter "Members -eq '$($User.DistinguishedName)'" -RecipientTypeDetails MailUniversalDistributionGroup | Format-List DisplayName, ExternalDirectoryObjectId, RecipientTypeDetails
  

Cenário 2: Executar cmdlets do Exchange Online e expandir propriedades específicas

Este exemplo localiza todas as caixas de correio em que a permissão GrantSendOnBehalfTo está definida e, em seguida, retorna os usuários que têm a permissão na caixa de correio.

• Em uma sessão remota do PowerShell: Use o cmdlet Get-PSSession para armazenar os detalhes da sessão remota do PowerShell na variável chamada $Sessione execute o seguinte comando:

  Invoke-Command -Session $Session -ScriptBlock {Get-Mailbox -Filter "GrantSendOnBehalfTo -ne `$null" -ErrorAction SilentlyContinue | Select-Object ExternalDirectoryObjectId, GrantSendOnBehalfTo -ExpandProperty GrantSendOnBehalfTo}
  

• Em uma sessão da API REST: Execute o seguinte comando:

  $mailboxes = Get-Mailbox -Filter "GrantSendOnBehalfTo -ne `$null"
  
  foreach ($mailbox in $mailboxes)
  
  {
    $users = $mailbox | Select-Object GrantSendOnBehalfTo -ExpandProperty GrantSendOnBehalfTo | Get-User
  
    $users | Select-Object Name, Guid
  }
  

Cenário 3: Executar cmdlets do Exchange Online em uma sessão específica do PowerShell quando várias sessões estiverem presentes

Este exemplo mostra como criar duas sessões do PowerShell na mesma janela e executar o cmdlet Get-Mailbox em cada sessão.

• Em uma sessão remota do PowerShell:

  1. Use o cmdlet Get-PSSession para armazenar os detalhes da primeira sessão remota do PowerShell na variável chamada $Session1.

  2. Use o cmdlet Get-PSSession para armazenar os detalhes da segunda sessão remota do PowerShell na variável chamada $Session2.

  3. Execute os seguintes comandos:

     Invoke-Command -Session $Session1 -ScriptBlock {Get-Mailbox -ResultSize 1}
     
     Invoke-Command -Session $Session2 -ScriptBlock {Get-Mailbox -ResultSize 1}
     

• Em uma sessão da API REST:

  1. No primeiro comando Connect-ExchangeOnline , use o parâmetro Prefix com o valor C1.

  2. Armazene os primeiros detalhes de conexão da API REST na variável nomeada $ConnectionInfo1 executando o seguinte comando:

     $ConnectionInfo1 = Get-ConnectionInformation | Where-Object { $_.ModulePrefix -eq "C1"}
     

  3. No segundo comando Connect-ExchangeOnline , use o parâmetro Prefix com o valor C2.

  4. Armazene os detalhes da segunda conexão da API REST na variável nomeada $ConnectionInfo2 executando o seguinte comando:

     $ConnectionInfo1 = Get-ConnectionInformation | Where-Object { $_.ModulePrefix -eq "C2"}
     

  5. Agora você pode executar comandos em qualquer sessão. Por exemplo:

     $CommandStr1 = "Get-$($ConnectionInfo1.ModulePrefix)Mailbox -ResultSize 10"
     
     Invoke-Expression $CommandStr1
     

     Ou

     $CommandStr2 = "Get-$($ConnectionInfo2.ModulePrefix)Mailbox -ResultSize 10"
     
     Invoke-Expression $CommandStr2