在 Windows Server 中設定和管理 SMB 政策控制器(預覽版)

SMB 政策控制器(預覽版)會儲存裝置或現有檔案共用所需的伺服器訊息區塊(SMB)設定,並在受管理的設定發生偏離時加以修正。 當您需要讓伺服器範圍和共用層級的設定與已定義的安全性或效能目標保持一致時,請使用。

在本文中,您將使用 Windows PowerShell 管理伺服器範圍及共享層級的 SMB 意圖,並完成其生命週期,同時驗證有效的配置是否符合您預期的結果。

Important

SMB Policy Controller 目前處於預覽階段。 此資訊涉及可能在上市前進行重大修改的預發布產品。 Microsoft 對於此處提供的資訊,不作任何明示或默示的保證。

Prerequisites

  • Windows Server Insider Preview 組建 29707 或更新版本。
  • 裝置上已提升權限的 Windows PowerShell 工作階段。 有關說明,請參閱「以管理權限啟動 Windows PowerShell」。
  • 對受影響裝置的管理存取權。 伺服器意圖負責管理本地 SMB 伺服器設定、SMB 用戶端設定、受管理的 SMB 登錄設定,以及替代埠設定。
  • 供共用意圖程序使用的現有 SMB 共用 SMB 政策控制者(預覽版)不會建立共用、其資料夾或其權限。
  • 代表性的用戶端與使用者身份,用於存取測試。
  • 變更計畫,用以識別受影響的伺服器、共用資料夾、用戶端及其他可變更相同 SMB 設定的設定工具。
  • 建立意圖前的有效 SMB 設定紀錄。 當您確認移除後,管理設定已回復到意圖建立前的值時,請使用此記錄。

安裝 SMB Policy Controller(預覽版)

在執行 Windows Server Insider Preview 29707 或更新版本的裝置上,安裝 SMB Policy Controller(預覽)隨選功能,並在設定意圖前確認其已準備好。

  1. 以管理員身份開啟 Windows PowerShell。

  2. 透過直接呼叫 PolicyController,啟用 SMB Policy Controller 隨選功能(dism.exe)。

    dism.exe /Online /Enable-Feature /FeatureName:PolicyController
    

    直接使用 dism.exe ,因為 DISM PowerShell 指令不會啟用 PowerShell 7 中的 SMB Policy Controller 按需功能。

  3. 如果 DISM 要求重新啟動,請重新啟動裝置。

  4. 如果您重新啟動了裝置,請以系統管理員身分重新開啟 Windows PowerShell。

  5. 驗證模組、其指令及服務。

    Import-Module PolicyController -ErrorAction Stop
    Get-Command -Module PolicyController
    Get-Service -Name PolicyController
    

    確認模組已匯入,指令清單顯示模組的指令,且 PolicyController 服務狀態為 Running。 如果安裝驗證失敗,請不要繼續進行意圖設定。

選擇意圖範圍

選擇伺服器層級意圖,以管理主機層級的 SMB 伺服器、SMB 用戶端、受管理的 SMB 登錄檔設定及替代連接埠組態。 選擇一個共享層級的意圖,以管理一個已命名的現有 SMB 共享。 這些範圍是分開的。 當兩種意圖都存在時,請驗證它們合併後的有效設定。

有關範圍互動及其他管理相同設定的工具詳細資訊,請參閱《伺服器與共用意圖》。

選擇設定檔與工作負載選擇器

當強化 SMB 防護為優先事項時,請選擇 安全性 設定檔。 當工作負載效能是優先考量,並且您接受其安全性與可用性權衡時,請選擇 效能 設定檔。 對於共用意圖,也選擇 使用者資料 工作負載選擇器,以設定人員與團隊互動式使用的共用資料夾,或選擇 應用程式資料 工作負載選擇器,以設定應用程式用於資料的共用資料夾。 在你建立意圖之前,先做出這些選擇。 有關設定檔效果、權衡與工作負載選擇器的指引,請參閱 SMB 政策控制器(預覽)設定檔與工作負載選擇器。 有關覆寫行為與限制,請參閱 SMB Policy Controller 從設定檔衍生的覆寫。

對於新的意圖,當支援的設定必須與其設定檔值不同時,請使用覆寫物件。 對於現有的意圖,請擷取目前的意圖,只編輯所需的屬性,並使用 Set-Intent -Override 提交編輯後的物件。 此模式會保留您不打算更改的設定。

設定意圖

選取您想要設定的意圖範圍的標籤。

伺服器整體意圖管理主機範圍的 SMB 伺服器、SMB 用戶端、受管理的 SMB 登錄機碼設定,以及替代連接埠的設定。 當你需要同時使用兩個範圍時,請與一個或多個共享意圖一併套用。 若要設定全伺服器的意圖,請依照下列步驟操作。

  1. 檢查現有的整個伺服器意圖。

    Get-Intent -System
    

    如果有意圖存在,就不要再加一個。 改用該更新程序。 如果指令回報讀取或持續性錯誤,請先解決該錯誤後再繼續。

  2. 檢視目前有效的 SMB 配置,並確認當 SMB 保護為優先時,您選擇 了安全性 設定檔;當工作負載效能為優先,並接受其安全性與可用性的取捨時,您選擇了 安全性 設定檔。 如需詳細指引,請參閱 SMB 政策控制器(預覽)設定檔與工作負載選擇器。

    Get-SmbServerConfiguration
    Get-SmbClientConfiguration
    
  3. 建立全伺服器的安全意圖。

    Add-Intent -Security
    

    若要建立 Performance 意圖,請使用 Add-Intent -Performance。 不要同時執行兩個指令。

    完成後 Add-Intent ,SMB 政策控制器(預覽版)會儲存所需的意圖並啟動應用程式嘗試。 若要確認有效設定與用戶端存取,請驗證意圖。

  4. 立即完成 驗證程序。

新增自訂意圖

在 SMB Policy Controller(預覽版)中,選取您想要自訂的意圖範圍的標籤。

對於新的伺服器範圍意圖,當支援的設定必須與所選內建設定檔不同時,請使用覆寫物件。 以下程序會建立 Security-profile 伺服器組態、要求 SMB 伺服器簽章,並套用自訂物件:

  1. 建立並自訂覆寫物件。

    $override = New-IntentOverride -Security
    $override.SmbServerConfiguration.RequireSecuritySignature = $true
    
  2. 新增自訂的全伺服器意圖。

    Add-Intent -Override $override
    

    不要在 Add-Intent 上將 -Security 與 -Performance 或 -Override 合併。 覆寫物件已包含設定檔選項。

  3. 立即完成 驗證程序。

更新意圖

使用 get、edit 和 set 模式來保留您不打算變更的設定。 新的覆寫物件會使用設定檔,而不是複製現有的意圖或目前的 Live 設定。 選取您想要更新的意圖範圍的標籤。

  1. 讀取目前伺服器層級的意圖。

    $intent = Get-Intent -System
    if ($null -eq $intent) {
        throw "The server didn't return a readable server-wide intent."
    }
    $intent
    
  2. 檢視完整物件後,僅變更所需的屬性。 此範例需要 SMB 伺服器簽章。

    $intent.SmbServerConfiguration.RequireSecuritySignature = $true
    
  3. 提交已編輯的物件。

    Set-Intent -Override $intent
    

    Set-Intent 完成後,SMB 政策控制器(預覽版)會儲存更新後的意圖並啟動應用程式嘗試。 若要確認有效設定與用戶端存取,請確認其意圖。

  4. 完成 驗證程序。

這些範例會更新現有意圖類型中所選定的設定。 它們並未建立設定檔遷移程序,也不會建立在使用者資料與應用程式資料意圖類型之間切換的程序。

驗證意圖

使用三個客戶端相關的證據層:已儲存的設定意向、有效或觀察到的配置,以及具代表性的客戶端成功案例。 請檢查每一層,因為僅憑已儲存的預期設定,無法證明設定已生效,或用戶端可以使用該共用。 已安裝的 Windows 版本可能會顯示不同的狀態細節,因此不要依賴特定的欄位標籤。

  1. 閱讀相關的儲存意圖以確認已儲存的範圍、設定檔與設定。

    Get-Intent -System
    Get-Intent -ShareName 'Documents'
    

    只執行您正在驗證的範圍所對應的指令。 檢查完整回傳物件及任何可用的狀態資訊。 不要把指令錯誤解讀成沒有意圖存在的證據。

  2. 讀取伺服器與用戶端針對整個伺服器意圖的有效或觀察到的配置。 這些證據顯示相關的全主機設定是否與儲存的意圖相符。

    Get-SmbServerConfiguration
    Get-SmbClientConfiguration
    
  3. 閱讀共用意圖的有效或已觀察到的共用設定。 此證據顯示相關分享設定是否與儲存的意圖相符。

    Get-SmbShare -Name 'Documents' -ErrorAction Stop |
        Format-List Name, ScopeName, Path, Description, FolderEnumerationMode,
            CachingMode, LeasingMode, CaTimeout, CompressData, ConcurrentUserLimit,
            ContinuouslyAvailable, DirectoryHandleLeasing, DisableClientMetadataCaching,
            EncryptData, IsolatedTransport
    
  4. 將所有相關的受管理設定與已儲存的預期設定及已核准的變更計畫進行比較。 檢查每個受影響的組態群組,而非僅依賴單一摘要結果。

  5. 針對伺服器整體的設定目標,請從受控裝置測試其通常使用之遠端共用上的代表性 SMB 用戶端外寄作業。 如果受管理裝置承載共享資料夾,也請測試代表性用戶端的連入存取。 對於共用意圖,請從具代表性的用戶端測試該共用。 使用具代表性的使用者身份與工作負載操作,並驗證適用的預期讀、寫及拒絕存取情境。

  6. 記錄結果與觀察時間。 群組原則、腳本、叢集作業或其他設定工具變更相同設定後,請重新檢查。

重試意圖套用

系統會限制重試套用的次數。 只有在找出並修正失敗原因後,才可重試。 不要將重複重試自動化,也不要依賴假設的重試排程、嘗試次數或計數器重設行為。

  1. 確認該意圖已啟用,且沒有任何作業正在將其移除。

    Get-Intent -System
    Get-Intent -ShareName 'Documents'
    

    執行針對受影響範圍的指令。

  2. 修正 SMB Policy Controller 所回報的根本問題。

    • 重試全伺服器的意向。

      Set-Intent -Retry
      

      若為分享意圖,請執行:

      Set-Intent -ShareName 'Documents' -Retry
      
  3. 完成 驗證程序。

Set-Intent -Retry 重新套用啟用意圖。 這不是設定檔變更、回滾,或重試未完成的移除。 不要讓它陷入不受控制的循環。

收集診斷資訊

收集同一時期的儲存意圖、有效狀態、服務及客戶證據。 這些資訊有助於區分控制器問題與一般 SMB 連線問題。

  1. 記錄服務與模組狀態。

    Get-Service -Name PolicyController
    Get-Module -ListAvailable -Name PolicyController
    Get-Command -Module PolicyController
    
  2. 擷取適用的意圖物件及任何錯誤,且不更改它。

    Get-Intent -System
    Get-Intent -ShareName 'Documents'
    
  3. 擷取有效的 SMB 設定。

    Get-SmbServerConfiguration
    Get-SmbClientConfiguration
    Get-SmbShare -Name 'Documents' -ErrorAction Stop |
        Format-List Name, ScopeName, Path, Description, FolderEnumerationMode,
            CachingMode, LeasingMode, CaTimeout, CompressData, ConcurrentUserLimit,
            ContinuouslyAvailable, DirectoryHandleLeasing, DisableClientMetadataCaching,
            EncryptData, IsolatedTransport
    
  4. 記錄伺服器時間、受影響的共用身份、用戶端身份、操作及錯誤訊息。 請包含 Intent 所報告的任何觀察時間。

  5. 檢視同一期間的 SMB 用戶端與伺服器事件記錄。 有關記錄位置及一般連線檢查,請參閱 「SMB 疑難排解」。

  6. 如果您的支援流程需要針對控制器進行追蹤,請先檢查已安裝模組所提供的追蹤說明。

    Get-Help Set-IntentTracing -Full
    

    僅依照已安裝 PolicyController 模組說明中的追蹤程序、輸出位置及資料處理需求操作。 本文不假設追蹤路徑、提供者、檔案大小或遠端追蹤行為。

移除意圖並返回先前設定

選取您想要移除的意圖範圍的標籤。

當移除成功時,SMB 政策控制器(預覽版)會回傳其在首次套用意圖前擷取的受管理主機設定值,而非安全性或效能設定檔的預設值。 移除伺服器範圍的意圖會影響受管理的 SMB 伺服器、SMB 用戶端、登錄檔及替代連接埠設定。 在繼續之前,請考量廣泛移除所選擇的每個伺服器與共用目標。

  1. 記錄全伺服器的意圖及所有相關的有效伺服器設定。

    Get-Intent -System
    Get-SmbServerConfiguration
    Get-SmbClientConfiguration
    
  2. 利用您的變更計畫與意圖紀錄,將所有持續或不完整且可能由廣泛移除選取的共用意圖的生命週期納入考量。 對於仍存在的每一個受影響的共享,記錄其儲存的意圖及相關有效管理設定。 請以共用名稱取代 Documents ,並對每個受影響的現有共用資料夾重複這些指令。 如果你無法掌握清楚每個目標及其基準,就不要使用廣泛移除。

    Get-Intent -ShareName 'Documents'
    Get-SmbShare -Name 'Documents' -ErrorAction Stop |
        Format-List Name, ScopeName, Path, Description, FolderEnumerationMode,
            CachingMode, LeasingMode, CaTimeout, CompressData, ConcurrentUserLimit,
            ContinuouslyAvailable, DirectoryHandleLeasing, DisableClientMetadataCaching,
            EncryptData, IsolatedTransport
    
  3. 在使用廣泛移除前,請先檢視已安裝的模組說明及您的變更計畫。

    Get-Help Remove-Intent -Full
    
  4. 開始整個伺服器範圍的移除。

    Warning

    未提供參數時執行 Remove-Intent 等同於 Remove-Intent -System。 它會選擇伺服器意圖以及所有持續或不完整的共享意圖生命週期,且不會提示確認。 操作可能部分完成或失敗。 在叢集中,資源所有權或離線參與節點可能會延遲完成或導致其失敗。 您必須指定 -ShareName 以進行僅移除共用。

    Remove-Intent -System
    

    在成功處理期間,SMB Policy Controller 會在完成移除作業所選擇的每個意圖之前,將所擷取的管理設定回回其預設意圖值。

  5. 確認每個操作所選目標的移除已完成,且 SMB Policy Controller 將受管理設定回復到其預設值。 請檢查有效配置,而非假設指令提交代表作業已完成。

  6. 將有效設定與每個受影響目標的意圖前紀錄進行比較,並測試具代表性的用戶端存取。

  7. 如果移除未完成,請保留證據並修正所報告的原因。

  8. 在您修正已回報的原因後,請執行 Remove-Intent -System 以重試所有未完成的移除。 不要使用 Set-Intent -Retry,因為它會重試套用作用中意圖,也不要手動刪除控制器復原紀錄。

移除操作不會刪除共享資料夾或資料,也不是備份還原。 SMB Policy Controller 會將其所擷取的受管理設定還原為意圖套用前的值。

針對常見問題進行疑難排解

收集診斷資料後,請依照以下指引操作。 不要刪除控制器復原紀錄或套用未記載的修復指令。

Problem 建議的動作
新增指出意圖已存在的內容 先閱讀現有的意圖物件,然後使用取得、編輯和設定模式。 不要只是為了讓 Add 成功而移除它。
系統找不到該共用 請用 Get-SmbShare確認其精確名稱、路徑與作用範圍。 SMB 政策控制器(預覽版)不會建立該共享資料夾。
儲存的意圖與有效設定不同 檢查已報告的應用程式錯誤、服務健康狀況、設定適用性、擁有權及其他設定寫入器。 檢查每個受管理群組,因為套用可能不完整。
修正後再次發生漂移 檢查群組原則、指令碼、管理工具或系統管理員是否寫入相同設定。 協調寫入程序,而不是一再強迫修改。
用戶端存取失敗,儘管設定看起來符合標準 請分別排除驗證、授權、網路、名稱解析、方言交涉及用戶端工作負載。 合規觀察並非客戶端存取測試。
重試無法解決問題 停止重試,保留證據,並調查根本錯誤。
無法完成移除作業 保留證據、修正所報告的原因,然後重試同一 Remove-Intent 指令。