SMB Policy Controller (preview) configureren en beheren in Windows Server

SMB Policy Controller (preview) slaat de Server Message Block (SMB)-instellingen op die u wilt voor een apparaat of een bestaande bestandsshare en corrigeert beheerde instellingen wanneer ze afwijken. Gebruik het wanneer configuratie op serverbreed niveau en shareniveau afgestemd moet blijven op een vastgesteld beveiligings- of prestatiedoel.

In dit artikel gebruikt u Windows PowerShell om de intenties van SMB op server- en share-niveau gedurende hun levenscyclus te beheren, terwijl u verifieert dat de effectieve configuratie overeenkomt met uw beoogde uitkomst.

Important

SMB Policy Controller staat momenteel in PREVIEW. Deze informatie heeft betrekking op een prerelease-product dat aanzienlijk kan worden gewijzigd voordat het wordt uitgebracht. Microsoft geeft geen garanties, expliciet of impliciet, met betrekking tot de informatie die hier wordt verstrekt.

Prerequisites

  • Windows Server Insider Preview build 29707 of hoger.
  • Een Windows PowerShell-sessie met verhoogde bevoegdheden op het apparaat. Zie voor instructies Windows PowerShell starten met beheerdersrechten.
  • Beheertoegang tot het getroffen apparaat. Een serverintentie beheert de lokale SMB-serverconfiguratie, SMB-clientconfiguratie, beheerde SMB-registerinstellingen en alternatieve poortconfiguratie.
  • Een bestaande SMB-share voor de procedures voor share-intent. SMB Policy Controller (preview) maakt de share, de map of de machtigingen daarvan niet aan.
  • Representatieve clients en gebruikersidentiteiten voor toegangstesten.
  • Een wijzigingsplan dat getroffen servers, shares, clients en andere configuratietools identificeert die dezelfde SMB-instellingen kunnen wijzigen.
  • Een overzicht van de effectieve SMB-instellingen voordat je een intent maakt. Gebruik dit record wanneer u verifieert dat het verwijderen de beheerde instellingen heeft teruggebracht naar hun waarden van vóór de intent.

SMB Policy Controller installeren (preview)

Installeer op een apparaat dat Windows Server Insider Preview build 29707 of hoger draait, de SMB Policy Controller (preview) functie on Demand en controleer of deze klaar is voordat u een intentie configureert.

  1. Open Windows PowerShell als beheerder.

  2. Schakel de SMB Policy Controller-functie on Demand (PolicyController) in door dism.exe rechtstreeks aan te roepen.

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

    Gebruik dism.exe rechtstreeks, omdat de DISM PowerShell-cmdlets de SMB Policy Controller Feature on Demand niet vanuit PowerShell 7 inschakelen.

  3. Als DISM een herstart aanvraagt, start het apparaat dan opnieuw op.

  4. Als u het apparaat opnieuw hebt opgestart, open dan Windows PowerShell opnieuw als beheerder.

  5. Controleer de module, de commando's en de service.

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

    Bevestig dat de module kan worden geïmporteerd, de commandolijst de commando's van de module toont en de servicestatus van PolicyControllerRunning is. Als de installatieverificatie mislukt, ga dan niet door met de intent-configuratie.

Kies een intentiescope

Kies een serverbrede intentie om de hostbrede SMB-server, de SMB-client, de beheerde SMB-registerinstellingen en de alternatieve poortconfiguratie te beheren. Kies een intentie op share-niveau om één benoemde, bestaande SMB-share te beheren. De scopes zijn gescheiden. Wanneer beide intenties bestaan, verifieer dan hun gecombineerde effectieve instellingen.

Zie voor details over scope-interacties en andere tools die dezelfde instellingen beheren Server- en share-intent.

Kies een profiel en een werklastselector

Kies het beveiligingsprofiel wanneer het versterken van SMB-beveiliging de prioriteit is. Kies het Prestatieprofiel wanneer workload-prestaties prioriteit hebben en u de beveiligings- en beschikbaarheidscompromisen accepteert. Voor een share-intentie kies je ook de User data workload selector voor shares die mensen en teams interactief gebruiken of de Application Data workload selector voor shares die applicaties gebruiken voor data. Maak deze keuzes voordat je de intentie maakt. Voor profieleffecten, compromisen en richtlijnen voor workload selector, zie SMB Policy Controller (preview) profielen en workload selectors. Zie SMB Policy Controller-profielafgeleide overschrijvingen voor overridegedrag en beperkingen.

Voor een nieuwe intentie gebruik je een override-object wanneer een ondersteunde instelling moet afwijken van de profielwaarde. Haal voor een bestaande intentie de huidige intentie op, bewerk alleen de vereiste eigenschappen en dien het bewerkte object in met Set-Intent -Override. Dit patroon behoudt instellingen die je niet van plan bent te veranderen.

Intent configureren

Selecteer het tabblad voor de intentiescope die u wilt configureren.

Een serverbrede intentie beheert de hostbrede SMB-server, de SMB-client, beheerde SMB-registerinstellingen en alternatieve poortconfiguratie. Pas het toe samen met één of meer share-intents wanneer je beide scopes nodig hebt. Gebruik de volgende stappen om een serverbrede intentie te configureren.

  1. Controleer of er een bestaande serverbrede intentie is.

    Get-Intent -System
    

    Als er een intentie bestaat, voeg dan geen nieuwe toe. Gebruik in plaats daarvan de updateprocedure. Als het commando een lees- of persistencefout meldt, los de fout op voordat u verder gaat.

  2. Bekijk de huidige effectieve SMB-configuratie en bevestig dat u het Beveiligingsprofiel hebt gekozen wanneer SMB-bescherming prioriteit heeft of het Prestatieprofiel wanneer workload-prestaties prioriteit hebben en u de afwegingen van beveiliging en beschikbaarheid accepteert. Voor gedetailleerde richtlijnen, zie SMB Policy Controller (preview)-profielen en workload-selectors.

    Get-SmbServerConfiguration
    Get-SmbClientConfiguration
    
  3. Maak de serverbrede beveiligingsintentie aan.

    Add-Intent -Security
    

    Gebruik Add-Intent -Performance om in plaats daarvan een prestatieintentie te creëren. Voer niet beide commando's uit.

    Wanneer Add-Intent is voltooid, slaat SMB Policy Controller (preview) de gewenste intentie op en is een toepassingspoging gestart. Controleer de intent om de effectieve instellingen en clienttoegang te bevestigen.

  4. Voltooi onmiddellijk de verificatieprocedure.

Voeg een aangepaste intentie toe

Selecteer in SMB Policy Controller (voorbeeld) het tabblad voor de intentiescope die u wilt aanpassen.

Voor een nieuwe serverbrede intentie gebruik je een override-object wanneer een ondersteunde instelling moet afwijken van het geselecteerde ingebouwde profiel. Met de volgende procedure wordt een beveiligingsprofiel-serverconfiguratie gemaakt, wordt SMB-serverondertekening vereist en wordt het aangepaste object toegepast:

  1. Maak het override-object aan en pas het aan.

    $override = New-IntentOverride -Security
    $override.SmbServerConfiguration.RequireSecuritySignature = $true
    
  2. Voeg de aangepaste serverbrede intentie toe.

    Add-Intent -Override $override
    

    Combineer -Override niet met -Security of -Performance op Add-Intent. Het override-object bevat de profielkeuze al.

  3. Voltooi onmiddellijk de verificatieprocedure.

Een intent bijwerken

Gebruik het patroon 'ophalen, bewerken en instellen' om instellingen te behouden die je niet wilt wijzigen. Een nieuw override-object gebruikt een profiel in plaats van de bestaande intent of de huidige live-configuratie te klonen. Selecteer het tabblad voor het intentbereik dat u wilt bijwerken.

  1. Lees de huidige serverbrede intent.

    $intent = Get-Intent -System
    if ($null -eq $intent) {
        throw "The server didn't return a readable server-wide intent."
    }
    $intent
    
  2. Controleer het volledige object en wijzig vervolgens alleen de vereiste eigenschap. Dit voorbeeld vereist ondertekening op de SMB-server.

    $intent.SmbServerConfiguration.RequireSecuritySignature = $true
    
  3. Dien het bewerkte object in.

    Set-Intent -Override $intent
    

    Wanneer Set-Intent is voltooid, slaat SMB Policy Controller (preview) de bijgewerkte intentie op en start een applicatiepoging. Om de effectieve instellingen en clienttoegang te bevestigen, controleert u het intent.

  4. Voltooi de verificatieprocedure.

Deze voorbeelden werken geselecteerde instellingen bij binnen een bestaand intentietype. Ze definiëren geen profielmigratieprocedure of een procedure voor het wisselen tussen gebruikersdata- en applicatiedataintentietypes.

Een intent verifiëren

Gebruik drie klantgerichte bewijslagen: de opgeslagen intentie, de effectieve of waargenomen configuratie en representatieve succesvolle clientresultaten. Controleer elke laag omdat een opgeslagen intentie alleen niet bewijst dat de instellingen effectief zijn of dat clients de share kunnen gebruiken. De geïnstalleerde Windows-build kan verschillende statusdetails tonen, dus wees niet afhankelijk van specifieke veldlabels.

  1. Lees de relevante opgeslagen intentie om de opgeslagen scope, het profiel en de instellingen te bevestigen.

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

    Voer alleen het commando uit voor de scope die je verifieert. Controleer het volledige teruggegeven object en eventuele beschikbare statusinformatie. Interpreteer een commandofout niet als bewijs dat er geen intentie bestaat.

  2. Lees de effectieve of waargenomen server- en clientconfiguratie voor een serverbrede intentie. Dit bewijs laat zien of de relevante hostbrede instellingen overeenkomen met de opgeslagen intentie.

    Get-SmbServerConfiguration
    Get-SmbClientConfiguration
    
  3. Lees de effectieve of waargenomen shareconfiguratie voor een shareintentie. Dit bewijs laat zien of de relevante share-instellingen overeenkomen met de opgeslagen intentie.

    Get-SmbShare -Name 'Documents' -ErrorAction Stop |
        Format-List Name, ScopeName, Path, Description, FolderEnumerationMode,
            CachingMode, LeasingMode, CaTimeout, CompressData, ConcurrentUserLimit,
            ContinuouslyAvailable, DirectoryHandleLeasing, DisableClientMetadataCaching,
            EncryptData, IsolatedTransport
    
  4. Vergelijk elke relevante beheerde instelling met de opgeslagen intentie en je goedgekeurde wijzigingsplan. Controleer elke getroffen configuratiegroep in plaats van te vertrouwen op één samenvattend resultaat.

  5. Voor een serverbrede intentie test je representatieve uitgaande SMB-clientoperaties vanaf het beheerde apparaat op externe shares die het normaal gesproken gebruikt. Als het beheerde apparaat shares bevat, test dan ook de inkomende toegang vanaf representatieve clients. Test bij een gedeelde-mapintentie de gedeelde map vanaf representatieve clients. Gebruik representatieve gebruikersidentiteiten en werklastoperaties en verifieer de verwachte gevallen van lezen, schrijven en geweigerde toegang die van toepassing zijn.

  6. Noteer de resultaten en de observatietijd. Controleer opnieuw nadat Groepsbeleid, scripts, clusteringoperaties of andere configuratietools dezelfde instellingen hebben gewijzigd.

Opnieuw proberen intent toe te passen

Het systeem beperkt de toepassingspogingen. Probeer het pas opnieuw nadat je de oorzaak van de fout hebt geïdentificeerd en verholpen. Automatiseer herhaalde pogingen niet en ga niet uit van een verondersteld schema voor nieuwe pogingen, een aantal pogingen of gedrag bij het resetten van tellers.

  1. Bevestig dat de intentie actief is en dat geen enkele operatie deze verwijdert.

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

    Voer het commando uit voor de getroffen scope.

  2. Corrigeer het onderliggende probleem dat door SMB Policy Controller is gemeld.

    • Probeer opnieuw een serverbrede intentie.

      Set-Intent -Retry
      

      Voor een deelintentie, voer uit:

      Set-Intent -ShareName 'Documents' -Retry
      
  3. Voltooi de verificatieprocedure.

Set-Intent -Retry Hiermee wordt een actieve intentie opnieuw toegepast. Het is geen profielwijziging, een rollback of een nieuwe poging na een onvolledige verwijdering. Plaats het niet in een ongecontroleerde lus.

Diagnostische gegevens verzamelen

Verzamel bewijs over opgeslagen intentie, effectieve toestand, service en clientbewijsmateriaal uit dezelfde periode. Deze informatie helpt u controllerproblemen te onderscheiden van algemene SMB-connectiviteitsproblemen.

  1. Registreer de service- en modulestatus.

    Get-Service -Name PolicyController
    Get-Module -ListAvailable -Name PolicyController
    Get-Command -Module PolicyController
    
  2. Registreer het toepasselijke intentieobject en eventuele fouten zonder het te wijzigen.

    Get-Intent -System
    Get-Intent -ShareName 'Documents'
    
  3. Leg de effectieve SMB-instellingen vast.

    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. Noteer de servertijd, de betreffende share-identiteit, clientidentiteit, bewerking en foutmelding. Neem eventuele observatietijden op die de Intent rapporteert.

  5. Bekijk de SMB-client- en servergebeurtenislogboeken voor dezelfde periode. Voor loglocaties en algemene connectiviteitscontroles, zie SMB-problemen oplossen.

  6. Als uw ondersteuningsproces controller-specifieke tracing vereist, inspecteer dan eerst de tracinghulp die de geïnstalleerde module levert.

    Get-Help Set-IntentTracing -Full
    

    Volg alleen de traceerprocedure, uitvoerlocatie en gegevensverwerkingsvereisten in de hulp voor de geïnstalleerde PolicyController-module. Dit artikel gaat niet uit van een traceerpad, provider, bestandsgrootte of gedrag voor afstandstracering.

Verwijder een intentie en keer terug naar eerdere instellingen

Selecteer het tabblad voor de intentiescope die u wilt verwijderen.

Wanneer verwijdering slaagt, geeft SMB Policy Controller (preview) de beheerde hostinstellingen terug naar de waarden die het heeft vastgelegd voordat de intentie voor het eerst werd toegepast, niet naar de standaardinstellingen voor het beveiligings- of prestatieprofiel. Het verwijderen van een serverbrede bedoeling heeft invloed op de configuratie van de beheerde SMB-server, SMB-client, registerinstellingen en alternatieve poortconfiguratie. Houd rekening met elke server en elk gedeeld doel die door de brede verwijdering worden geselecteerd voordat je doorgaat.

  1. Noteer de serverbrede intentie en alle relevante effectieve serverinstellingen.

    Get-Intent -System
    Get-SmbServerConfiguration
    Get-SmbClientConfiguration
    
  2. Gebruik uw wijzigingsplan en intentiegegevens om elke opgeslagen of onvolledige levensduur van share-intentie te omvatten die door brede verwijdering kan worden meegenomen. Registreer voor elke getroffen share die nog bestaat de opgeslagen intentie en relevante effectieve beheerde instellingen. Vervang Documents door de naam van de share en herhaal deze commando's voor elke getroffen bestaande share. Als je niet elke target en de bijbehorende baseline kunt verantwoorden, gebruik dan geen algemene verwijdering.

    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. Bekijk de hulp bij geïnstalleerde modules en je wijzigingsplan voordat je algemene verwijdering gebruikt.

    Get-Help Remove-Intent -Full
    
  4. Start de serverbrede verwijdering.

    Warning

    Het uitvoeren van Remove-Intent zonder parameters is gelijk aan Remove-Intent -System. Het selecteert de serverintentie en alle bewaarde of onvolledige share-intent-levensduren, en vraagt niet om bevestiging. De operatie kan gedeeltelijk voltooid worden of mislukken. In een cluster kan het eigendom van resources of offline deelnemende nodes de voltooiing vertragen of ervoor zorgen dat dit mislukt. U moet -ShareName opgeven voor alleen-shareverwijdering.

    Remove-Intent -System
    

    Tijdens succesvolle verwerking retourneert SMB Policy Controller de beheerde instellingen die het heeft vastgelegd naar hun pre-intentiewaarden voordat het elke intentie die de bewerking heeft geselecteerd heeft verwijderd.

  5. Controleer of de verwijdering is voltooid voor elk doel dat door de bewerking is geselecteerd en dat SMB Policy Controller de beheerde instellingen heeft teruggegeven naar hun pre-intentiewaarden. Controleer de effectieve configuratie in plaats van aan te nemen dat opdrachtindiening betekent dat de operatie is voltooid.

  6. Vergelijk effectieve instellingen met de pre-intentierecords voor elk getroffen doel en test representatieve clienttoegang.

  7. Als de verwijdering niet wordt voltooid, bewaar dan het bewijs en corrigeer de vastgestelde oorzaak.

  8. Nadat je de gerapporteerde oorzaak hebt gecorrigeerd, voer Remove-Intent -System uit om eventuele onvolledige verwijderingen opnieuw te proberen. Gebruik Set-Intent -Retry niet, dat een actieve intentie opnieuw toepast, en verwijder controllerherstelrecords niet handmatig.

De verwijderingsbewerking verwijdert geen gedeelde mappen of gegevens en is geen herstelbewerking vanaf een back-up. SMB Policy Controller zet de beheerde instellingen die het heeft vastgelegd terug naar de waarden van vóór de intent.

Veelvoorkomende problemen oplossen

Gebruik de volgende richtlijnen na het verzamelen van diagnostische gegevens. Verwijder geen controllerherstelrecords en pas geen ongedocumenteerde reparatiecommando's toe.

Problem Aanbevolen actie
Voeg toe dat er al een intent bestaat Lees de bestaande intent en gebruik vervolgens het patroon get, edit en set. Verwijder het niet alleen om Toevoegen te laten slagen.
Het systeem kan de share niet vinden Bevestig de exacte naam, het pad en de reikwijdte met Get-SmbShare. SMB Policy Controller (preview) maakt de share niet aan.
Opgeslagen intentie en effectieve instellingen verschillen Controleer gerapporteerde applicatiefouten, servicestatus, toepasbaarheid van instellingen, eigendom en andere configuratieschrijvers. Controleer elke beheerde groep, omdat de toepassing mogelijk slechts gedeeltelijk is.
Drift keert terug na correctie Controleer op groepsbeleid, scripts, beheertools of beheerders die dezelfde instellingen wijzigen. Coördineer schrijvers in plaats van herhaaldelijk wijzigingen af te dwingen.
Clienttoegang faalt hoewel instellingen conform lijken Onderzoek authenticatie, autorisatie, netwerken, naamresolutie, dialectonderhandeling en de clientworkload afzonderlijk. Een compliance-observatie is geen client-access-test.
Herproberen lost het probleem niet op Stop met opnieuw proberen, bewaar het bewijs en onderzoek de onderliggende fout.
Verwijderen is niet voltooid Bewaar het bewijs, corrigeer de gerapporteerde oorzaak en probeer hetzelfde Remove-Intent commando opnieuw.