Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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.
Open Windows PowerShell als beheerder.
Schakel de SMB Policy Controller-functie on Demand (
PolicyController) in doordism.exerechtstreeks aan te roepen.dism.exe /Online /Enable-Feature /FeatureName:PolicyControllerGebruik
dism.exerechtstreeks, omdat de DISM PowerShell-cmdlets de SMB Policy Controller Feature on Demand niet vanuit PowerShell 7 inschakelen.Als DISM een herstart aanvraagt, start het apparaat dan opnieuw op.
Als u het apparaat opnieuw hebt opgestart, open dan Windows PowerShell opnieuw als beheerder.
Controleer de module, de commando's en de service.
Import-Module PolicyController -ErrorAction Stop Get-Command -Module PolicyController Get-Service -Name PolicyControllerBevestig dat de module kan worden geïmporteerd, de commandolijst de commando's van de module toont en de servicestatus van
PolicyControllerRunningis. 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.
Controleer of er een bestaande serverbrede intentie is.
Get-Intent -SystemAls 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.
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-SmbClientConfigurationMaak de serverbrede beveiligingsintentie aan.
Add-Intent -SecurityGebruik
Add-Intent -Performanceom in plaats daarvan een prestatieintentie te creëren. Voer niet beide commando's uit.Wanneer
Add-Intentis 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.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:
Maak het override-object aan en pas het aan.
$override = New-IntentOverride -Security $override.SmbServerConfiguration.RequireSecuritySignature = $trueVoeg de aangepaste serverbrede intentie toe.
Add-Intent -Override $overrideCombineer
-Overrideniet met-Securityof-PerformanceopAdd-Intent. Het override-object bevat de profielkeuze al.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.
Lees de huidige serverbrede intent.
$intent = Get-Intent -System if ($null -eq $intent) { throw "The server didn't return a readable server-wide intent." } $intentControleer het volledige object en wijzig vervolgens alleen de vereiste eigenschap. Dit voorbeeld vereist ondertekening op de SMB-server.
$intent.SmbServerConfiguration.RequireSecuritySignature = $trueDien het bewerkte object in.
Set-Intent -Override $intentWanneer
Set-Intentis 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.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.
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.
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-SmbClientConfigurationLees 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, IsolatedTransportVergelijk 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.
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.
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.
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.
Corrigeer het onderliggende probleem dat door SMB Policy Controller is gemeld.
Probeer opnieuw een serverbrede intentie.
Set-Intent -RetryVoor een deelintentie, voer uit:
Set-Intent -ShareName 'Documents' -Retry
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.
Registreer de service- en modulestatus.
Get-Service -Name PolicyController Get-Module -ListAvailable -Name PolicyController Get-Command -Module PolicyControllerRegistreer het toepasselijke intentieobject en eventuele fouten zonder het te wijzigen.
Get-Intent -System Get-Intent -ShareName 'Documents'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, IsolatedTransportNoteer de servertijd, de betreffende share-identiteit, clientidentiteit, bewerking en foutmelding. Neem eventuele observatietijden op die de Intent rapporteert.
Bekijk de SMB-client- en servergebeurtenislogboeken voor dezelfde periode. Voor loglocaties en algemene connectiviteitscontroles, zie SMB-problemen oplossen.
Als uw ondersteuningsproces controller-specifieke tracing vereist, inspecteer dan eerst de tracinghulp die de geïnstalleerde module levert.
Get-Help Set-IntentTracing -FullVolg 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.
Noteer de serverbrede intentie en alle relevante effectieve serverinstellingen.
Get-Intent -System Get-SmbServerConfiguration Get-SmbClientConfigurationGebruik 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
Documentsdoor 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, IsolatedTransportBekijk de hulp bij geïnstalleerde modules en je wijzigingsplan voordat je algemene verwijdering gebruikt.
Get-Help Remove-Intent -FullStart de serverbrede verwijdering.
Warning
Het uitvoeren van
Remove-Intentzonder parameters is gelijk aanRemove-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-ShareNameopgeven voor alleen-shareverwijdering.Remove-Intent -SystemTijdens 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.
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.
Vergelijk effectieve instellingen met de pre-intentierecords voor elk getroffen doel en test representatieve clienttoegang.
Als de verwijdering niet wordt voltooid, bewaar dan het bewijs en corrigeer de vastgestelde oorzaak.
Nadat je de gerapporteerde oorzaak hebt gecorrigeerd, voer
Remove-Intent -Systemuit om eventuele onvolledige verwijderingen opnieuw te proberen. GebruikSet-Intent -Retryniet, 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. |