主題
    about_Foreach

簡短描述
    描述可用來周遊於項目集合中所有項目的語言命令。


完整描述
    Foreach 陳述式 (也稱為 Foreach 迴圈) 是一種語言建構，用以逐項 (反覆) 處理項目集合中
    的一連串數值。


    最簡單且最常周遊的集合類型是陣列。
    Foreach 迴圈內部常會對陣列中的每個項目執行一或多個命令。


  語法        
      Foreach 的語法如下：

        
          foreach ($<項目> in $<集合>){<陳述式清單>}


  命令管線外的 Foreach 陳述式 Foreach 陳述式置於括號中的部分代表變數以及所要反覆處理
  的集合。Windows PowerShell 會在 Foreach 迴圈執行時自動建立變數 ($<項目>)。每次反覆
  處理迴圈之前，會先將此變數設定為集合中的某個值。Foreach 陳述式後面的區塊 {<陳述式
  清單>} 包含了要對集合中的每個項目執行的一組命令。
 

  範例
      例如，下列 Foreach 迴圈範例將顯示 $letterArray 陣列中的值。

        
          $letterArray = "a","b","c","d"
          foreach ($letter in $letterArray)
          {
              Write-Host $letter
          }

      
      此範例使用字串值 "a"、"b"、"c" 和 "d" 建立並初始化 $letterArray 陣列。
      Foreach 陳述式第一次執行時，會將 $letter 變數設定為等於 $letterArray ("a") 
      中的第一個項目， 然後再使用 Write-Host Cmdlet 來顯示字母 a。下一次通過迴圈
      時，$letter 會設定為 "b"，以此類推。直到 Foreach 迴圈顯示字母 d 之後，Windows 
      PowerShell 隨即結束迴圈。


      在 Windows PowerShell 命令提示字元輸入時，整個 Foreach 陳述式必須寫成一行才能執
      行命令。如果是將命令放在 .ps1 指令檔中，則不需要以單一行顯示整個 Foreach 陳
      述式。


      Foreach 陳述式也能與傳回項目集合的 Cmdlet 搭配使用。在下列範例中，Foreach 陳述
      式將逐項處理 Get-ChildItem Cmdlet 所傳回的項目清單。


          foreach ($file in Get-ChildItem)
          {
              Write-Host $file
          }


      您可以修改上述範例，使用 If 陳述式限制傳回的結果。在下列範例中，Foreach 陳述式
      不僅執行與上述範例相同的迴圈處理作業，還加入 If 陳述式將結果限制為大小超過 100 
      KB 的檔案：


          foreach ($file in Get-ChildItem)
          {
              if ($file.length -gt 100k) 
              {
                  Write-Host $file
              }
          }


      在此範例中，Foreach 迴圈會利用 $file 變數的屬性執行比較運算 ($file.length -gt 100k)。
      $file 變數包含了 Get-ChildItem Cmdlet 所傳回物件的全部屬性。因此，您還能
      傳回檔名以外的其他資訊。在下列範例中，Windows PowerShell 於陳述式清單內傳回長
      度和上次存取時間：


          foreach ($file in Get-ChildItem)
          {
              if ($file.length -gt 100k) 
              {
                  Write-Host $file
                  Write-Host $file.length
                  Write-Host $file.lastaccesstime
              }
          }

    
      此範例中沒有在陳述式清單中執行單一命令的限制。

      
      您也可以在 Foreach 迴圈外使用變數，而在迴圈內遞增其值。下列範例會計算大小超
      過 100 KB 的檔案： 
      
  
          $i = 0
          foreach ($file in Get-ChildItem)
          {
              if ($file.length -gt 100k) 
              {
                  Write-Host $file "檔案大小：" ($file.length / 
                  1024).ToString("F0") KB
                  $i = $i + 1
              }
          }

          if ($i -ne 0)
          {
              Write-Host
              Write-Host $i " 個檔案在目前目錄中超過 100 KB。"}
          else 
          {
              Write-Host "目前目錄中沒有大於 100 KB 的檔案。"
          }


      在前述範例中，在迴圈外將 $i 變數設為 0，且迴圈內每找到一個大於 100 KB 的檔案時
      便遞增變數值。結束迴圈後，If 陳述式會評估 $i 的值以顯示所有超過 100 KB 的檔案
      數目， 或顯示訊息表示找不到大於 100 KB 的檔案。


      上述範例也示範如何將檔案長度結果格式化：


          ($file.length / 1024).ToString("F0")


      值先除以 1,024 而從位元組改為顯示以 KB 為單位的結果，然後使用固定小數點格式指
      定元移除結果中的小數點。當中的 0 係指示格式指定元不應顯示任何小數位數。


  命令管線內的 Foreach 陳述式 每當 Foreach 出現在命令管線內，Windows PowerShell 便會
  使用 foreach 別名藉以呼叫 ForEach-Object 命令。若在命令管線內使用 foreach 別名，
  就不必加上 Foreach 陳述式應有的 ($<項目> in $<集合>) 語法。這是因為管線內的上一個命
  令會提供此資訊。用於命令管線內的 foreach 別名使用下列語法：
        

          <命令> | foreach {<命令區塊>}
     

      例如，下列命令管線內的 Foreach 迴圈將顯示工作組 (記憶體使用量) 大於 20 MB 的所
      有處理序。Windows PowerShell 會將 Get-Process 命令的輸出傳送給 foreach 
      別名。而在 foreach 別名的命令區塊內，$_.WS 變數包含了由 Get-Process Cmdlet 
      傳來的 WS (工作組) 屬性的值  (宣告的 $_ 部分是 Windows Script Host [WSH] 
      自動變數，WS 部分則是屬性)。接著 If 陳述式使用條件陳述式判斷工作組是否大於 
      20 MB (20,000,000 位元組)。如果是，便會顯示處理序的名稱 (儲存於 $_.name 變數) 
      以及工作組的大小 (以 MB 為單位)。
      若所有的處理序工作組都不超過 20 MB，就不會顯示任何資訊。


          Write-Host "工作組大於 20 MB 的處理序" Get-Process | foreach { 
              if ($_.WS -gt 20m)
              {
                  Write-Host $_.name ": " 
          ($_.WS/1m).ToString("F0") MB -Separator ""
              }
          }

      foreach 別名也支援起始命令區塊、中間命令區塊以及結尾命令區塊。起始與結尾命令區
      塊僅執行一次，中間命令區塊則是在 Foreach 迴圈每次逐項處理集合或陣列時都會執行。
        

      在命令管線內使用，且包含起始、中間與結尾命令區塊之 foreach 別名的語法如下：
        

          <命令> | foreach {<起始命令區塊>}{<中間命令區塊>}{<結尾命令區塊>}

 
      下列範例示範起始、中間與結尾命令區塊的用法。


          Get-ChildItem | foreach {
          $fileCount = $directoryCount = 0}{
          if ($_.PsIsContainer) {$directoryCount++} else 
          {$fileCount++}}{ "$directoryCount 個目錄和 $fileCount 個檔案"}


      起始區塊會建立兩個變數並將其初始化為 0：


          {$fileCount = $directoryCount = 0}
 

      中間區塊會評估 Get-ChildItem 所傳回的每個項目是目錄或檔案：


          {if ($_.PsIsContainer) {$directoryCount++} else {$fileCount++}}


      如果傳回的項目是目錄，$directoryCount 變數會以 1 遞增。如果該項目不是目錄，
      $fileCount 變數會以 1 遞增。結束區塊會在中間區塊完成其迴圈作業之後執行，然
      後再傳回作業的結果。

       
          {"$directoryCount 個目錄和 $fileCount 個檔案"}


      您可以使用起始、中間與結尾命令區塊結構以及管線運算子來改寫稍早的範例，找出大小
      超過 100 KB 的檔案，如下所示：


          Get-ChildItem | foreach{
              $i = 0}{
              if ($_.length -gt 100k)
              {
                  Write-Host $_.name "檔案大小：" ($_.length / 
                  1024).ToString("F0") KB
                  $i++
              }
              }{
              if ($i -ne 0)
              {
                  Write-Host
                  Write-Host "$i 個檔案在目前目錄中超過 100 KB。"
              }
              else 
              {
              Write-Host "目前目錄中沒有大於 100 KB 的檔案。"}
              }


請參閱
    about_Automatic_Variables
    about_If
    Foreach-Object



目錄