共用方式為

REST API 連線中 Invoke-Command 案例的因應措施

  • 發行項

在相同視窗中與 Exchange Online 或 Security & Compliance PowerShell 的多個連線中，您可以使用 Invoke-Command Cmdlet 在特定遠端 PowerShell 工作階段中執行腳本或命令。 但是，Invoke-Command Cmdlet 無法在 REST API 連線中運作，無法 Exchange Online 或安全性 & 合規性 PowerShell。

本文針對使用 Invoke-Command 命令的案例提供 REST API 替代方案。

案例 1：執行 Exchange Online Cmdlet

此範例會尋找任何其他使用者 () $Us = $User.Identity 的身分識別。

提示

需要其他命令才能取得的 $User 值，因此 $Us為 。 這些命令並不重要。 正在使用的整體方法是很重要的。

  • 在遠端 PowerShell 會話中：使用 Get-PSSession Cmdlet 將遠端 PowerShell 會話詳細資料儲存在名為 的 $Session變數中，然後執行下列命令：

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

  • 在 REST API 工作階段中：執行下列命令：

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

此範例會尋找群組成員的身分識別：

  • 在遠端 PowerShell 會話中：使用 Get-PSSession Cmdlet 將遠端 PowerShell 會話詳細資料儲存在名為 的 $Session變數中，然後執行下列命令：

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

  • 在 REST API 工作階段中：執行下列命令：

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

案例 2：執行 Exchange Online Cmdlet 並展開特定屬性

此範例會尋找已設定 GrantSendOnBehalfTo 許可權的所有信箱，然後傳回擁有信箱許可權的使用者。

  • 在遠端 PowerShell 會話中：使用 Get-PSSession Cmdlet 將遠端 PowerShell 會話詳細資料儲存在名為 的 $Session變數中，然後執行下列命令：

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

  • 在 REST API 工作階段中：執行下列命令：

    $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
}

案例 3：當多個會話存在時，在特定 PowerShell 會話中執行 Exchange Online Cmdlet

此範例示範如何在同一個視窗中建立兩個 PowerShell 會話，並在每個會話中執行 Get-Mailbox Cmdlet。

  • 在遠端 PowerShell 工作階段中：

    1. 使用 Get-PSSession Cmdlet，將第一個遠端 PowerShell 會話詳細資料儲存在名為 的 $Session1變數中。

    2. 使用 Get-PSSession Cmdlet，將第二個遠端 PowerShell 會話詳細資料儲存在名為 的 $Session2變數中。

    3. 執行下列命令：

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

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

  • 在 REST API 工作階段中：

    1. 在第一個 Connect-ExchangeOnline 命令中，使用參數 Prefix 搭配值 C1。

    2. 執行下列命令，將第一個 REST API 連線詳細資料儲存在名為 $ConnectionInfo1 的變數中：

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

    3. 在第二 個 Connect-ExchangeOnline 命令中，使用參數 Prefix 搭配值 C2。

    4. 執行下列命令，將第二個 REST API 連線詳細資料儲存在名為 $ConnectionInfo2 的變數中：

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

    5. 現在您可以在任一會話中執行命令。 例如：

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

Invoke-Expression $CommandStr1

      或

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

Invoke-Expression $CommandStr2