2
2
description : Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
3
3
external help file : SmbClientConfiguration.cdxml-help.xml
4
4
Module Name : SmbShare
5
- ms.date : 10/20/2022
6
- online version : http ://go .microsoft.com/fwlink/?LinkID=241959
5
+ ms.date : 02/22/2024
6
+ online version : https ://learn .microsoft.com/powershell/module/smbshare/reset-smbclientconfiguration?view=windowsserver2025-ps&wt.mc_id=ps-gethelp
7
7
schema : 2.0.0
8
8
title : Reset-SmbClientConfiguration
9
9
---
@@ -16,34 +16,26 @@ Resets the Server Message Block (SMB) client configuration parameters to their d
16
16
## SYNTAX
17
17
18
18
```
19
- Reset-SmbClientConfiguration [-All] [-CompressibilitySampling]
20
- [-ConnectionCountPerRssNetworkInterface] [-DirectoryCacheEntriesMax] [-DirectoryCacheEntrySizeMax]
21
- [-DirectoryCacheLifetime] [-DisableCompression] [-DormantFileLimit] [-EnableBandwidthThrottling]
22
- [-EnableByteRangeLockingOnReadOnlyFiles] [-EnableLargeMtu] [-EnableLoadBalanceScaleOut]
23
- [-EnableMultiChannel] [-EncryptionCiphers] [-ExtendedSessionTimeout] [-FileInfoCacheEntriesMax]
24
- [-FileInfoCacheLifetime] [-FileNotFoundCacheEntriesMax] [-FileNotFoundCacheLifetime]
25
- [-ForceSMBEncryptionOverQuic] [-KeepConn] [-MaxCmds] [-MaximumConnectionCountPerServer]
26
- [-OplocksDisabled] [-RequestCompression] [-SessionTimeout] [-SkipCertificateCheck]
27
- [-UseOpportunisticLocking] [-WindowSizeThreshold] [-Force] [-CimSession <CimSession[]>]
28
- [-ThrottleLimit <Int32>] [-AsJob] [-WhatIf] [-Confirm] [<CommonParameters>]
19
+ Reset-SmbClientConfiguration [-All] [-AuditInsecureGuestLogon]
20
+ [-AuditServerDoesNotSupportEncryption] [-AuditServerDoesNotSupportSigning] [-BlockNTLM]
21
+ [-CompressibilitySampling] [-ConnectionCountPerRssNetworkInterface] [-DirectoryCacheEntriesMax]
22
+ [-DirectoryCacheEntrySizeMax] [-DirectoryCacheLifetime] [-DisableCompression] [-DormantFileLimit]
23
+ [-EnableBandwidthThrottling] [-EnableByteRangeLockingOnReadOnlyFiles] [-EnableLargeMtu]
24
+ [-EnableLoadBalanceScaleOut] [-EnableMailslots] [-EnableMultiChannel] [-EncryptionCiphers]
25
+ [-ExtendedSessionTimeout] [-FileInfoCacheEntriesMax] [-FileInfoCacheLifetime]
26
+ [-FileNotFoundCacheEntriesMax] [-FileNotFoundCacheLifetime] [-ForceSMBEncryptionOverQuic]
27
+ [-InvalidAuthenticationCacheLifetime] [-KeepConn] [-MaxCmds] [-MaximumConnectionCountPerServer]
28
+ [-OplocksDisabled] [-RequestCompression] [-RequireEncryption] [-SessionTimeout]
29
+ [-SkipCertificateCheck] [-Smb2DialectMax] [-Smb2DialectMin] [-UseOpportunisticLocking]
30
+ [-WindowSizeThreshold] [-Force] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob]
31
+ [-WhatIf] [-Confirm] [<CommonParameters>]
29
32
```
30
33
31
34
## DESCRIPTION
32
35
33
36
The ` Reset-SmbClientConfiguration ` cmdlet resets SMB client configuration parameters to their
34
37
default values.
35
38
36
- > [ !NOTE]
37
- > - This cmdlet is available beginning with 2022-06 Cumulative Update for Microsoft server operating
38
- > system version 21H2 for x64-based Systems
39
- > ([ KB5014665] ( https://support.microsoft.com/help/5014665 ) ), and Cumulative Update for Windows 11,
40
- > version 22H2 ([ KB5014668] ( https://support.microsoft.com/help/5014668 ) ).
41
- >
42
- > - The ** CompressibilitySampling** and ** RequestCompression** parameters are available beginning
43
- > with 2022-08 Cumulative Update for Microsoft server operating system version 21H2 for x64-based
44
- > Systems ([ KB5016693] ( https://support.microsoft.com/help/5016693 ) ), and Cumulative Update for
45
- > Windows 11, version 22H2 ([ KB5016691] ( https://support.microsoft.com/help/5016691 ) ).
46
-
47
39
## EXAMPLES
48
40
49
41
### Example 1: Reset the large MTU behavior
@@ -89,11 +81,75 @@ Accept pipeline input: False
89
81
Accept wildcard characters : False
90
82
` ` `
91
83
84
+ ### -AuditInsecureGuestLogon
85
+
86
+ Resets whether to audit insecure guest logon attempts to its default value.
87
+
88
+ ` ` ` yaml
89
+ Type : SwitchParameter
90
+ Parameter Sets : (All)
91
+ Aliases :
92
+
93
+ Required : False
94
+ Position : Named
95
+ Default value : None
96
+ Accept pipeline input : False
97
+ Accept wildcard characters : False
98
+ ` ` `
99
+
100
+ ### -AuditServerDoesNotSupportEncryption
101
+
102
+ Resets whether to audit when a server doesn't support encryption to its default value.
103
+
104
+ ` ` ` yaml
105
+ Type : SwitchParameter
106
+ Parameter Sets : (All)
107
+ Aliases :
108
+
109
+ Required : False
110
+ Position : Named
111
+ Default value : None
112
+ Accept pipeline input : False
113
+ Accept wildcard characters : False
114
+ ` ` `
115
+
116
+ ### -AuditServerDoesNotSupportSigning
117
+
118
+ Resets whether to audit when a server doesn't support message signing to its default value.
119
+
120
+ ` ` ` yaml
121
+ Type : SwitchParameter
122
+ Parameter Sets : (All)
123
+ Aliases :
124
+
125
+ Required : False
126
+ Position : Named
127
+ Default value : None
128
+ Accept pipeline input : False
129
+ Accept wildcard characters : False
130
+ ` ` `
131
+
132
+ ### -BlockNTLM
133
+
134
+ Resets whether to block NT LAN Manager (NTLM) authentication to its default value.
135
+
136
+ ` ` ` yaml
137
+ Type : SwitchParameter
138
+ Parameter Sets : (All)
139
+ Aliases :
140
+
141
+ Required : False
142
+ Position : Named
143
+ Default value : None
144
+ Accept pipeline input : False
145
+ Accept wildcard characters : False
146
+ ` ` `
147
+
92
148
### -CimSession
93
149
94
150
Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session
95
- object, such as the output of a [New-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227967 )
96
- or [Get-CimSession](https://go.microsoft.com/fwlink/p/?LinkId=227966 ) cmdlet. The default is the
151
+ object, such as the output of a [New-CimSession](/powershell/module/cimcmdlets/new-cimsession )
152
+ or [Get-CimSession](/powershell/module/cimcmdlets/get-cimsession ) cmdlet. The default is the
97
153
current session on the local computer.
98
154
99
155
` ` ` yaml
@@ -284,6 +340,28 @@ Accept pipeline input: False
284
340
Accept wildcard characters : False
285
341
` ` `
286
342
343
+ ### -EnableMailslots
344
+
345
+ Resets mailslots to its default value.
346
+
347
+ Beginning with Windows Server 2025 and Windows 11 Insider Preview Build 25314, remote mailslots are
348
+ disabled by default.
349
+
350
+ To learn more about remote mailslot deprecation, see [Features removed or no longer developed
351
+ starting with Windows Server 2025](/windows-server/get-started/removed-deprecated-features-windows-server-2025).
352
+
353
+ ` ` ` yaml
354
+ Type : SwitchParameter
355
+ Parameter Sets : (All)
356
+ Aliases :
357
+
358
+ Required : False
359
+ Position : Named
360
+ Default value : None
361
+ Accept pipeline input : False
362
+ Accept wildcard characters : False
363
+ ` ` `
364
+
287
365
### -EnableMultiChannel
288
366
289
367
Resets the enable multi-channel value to its default value.
@@ -428,6 +506,23 @@ Accept pipeline input: False
428
506
Accept wildcard characters : False
429
507
` ` `
430
508
509
+ ### -InvalidAuthenticationCacheLifetime
510
+
511
+ Resets the length of time (in seconds) that an invalid authentication cache entry should be kept
512
+ before being removed to its default value.
513
+
514
+ ` ` ` yaml
515
+ Type : SwitchParameter
516
+ Parameter Sets : (All)
517
+ Aliases :
518
+
519
+ Required : False
520
+ Position : Named
521
+ Default value : None
522
+ Accept pipeline input : False
523
+ Accept wildcard characters : False
524
+ ` ` `
525
+
431
526
### -KeepConn
432
527
433
528
Reset the time, in seconds, before the SMB client session is automatically disconnected to its
@@ -510,6 +605,24 @@ Accept pipeline input: False
510
605
Accept wildcard characters : False
511
606
` ` `
512
607
608
+ ### -RequireEncryption
609
+
610
+ Specifies whether or not encryption should be required for all SMB traffic. When this parameter is
611
+ set to ` $true`, all SMB traffic must be encrypted. If it is set to `$false` (the default),
612
+ encryption is not required, but may still be negotiated if both the client and server support it.
613
+
614
+ ` ` ` yaml
615
+ Type: SwitchParameter
616
+ Parameter Sets: (All)
617
+ Aliases:
618
+
619
+ Required: False
620
+ Position: Named
621
+ Default value: None
622
+ Accept pipeline input: False
623
+ Accept wildcard characters: False
624
+ ` ` `
625
+
513
626
# ## -SessionTimeout
514
627
515
628
Resets the session time-out value to its default value.
@@ -542,6 +655,40 @@ Accept pipeline input: False
542
655
Accept wildcard characters: False
543
656
` ` `
544
657
658
+ # ## -Smb2DialectMax
659
+
660
+ Resets the maximum version of the SMB protocol to be used back to its default value.
661
+
662
+ ` ` ` yaml
663
+ Type: SwitchParameter
664
+ Parameter Sets: (All)
665
+ Aliases:
666
+ Accepted values: None, SMB202, SMB210, SMB300, SMB302, SMB311
667
+
668
+ Required: False
669
+ Position: Named
670
+ Default value: None
671
+ Accept pipeline input: False
672
+ Accept wildcard characters: False
673
+ ` ` `
674
+
675
+ # ## -Smb2DialectMin
676
+
677
+ Resets the minimum version of the SMB protocol to be used back to its default value.
678
+
679
+ ` ` ` yaml
680
+ Type: SwitchParameter
681
+ Parameter Sets: (All)
682
+ Aliases:
683
+ Accepted values: None, SMB202, SMB210, SMB300, SMB302, SMB311
684
+
685
+ Required: False
686
+ Position: Named
687
+ Default value: None
688
+ Accept pipeline input: False
689
+ Accept wildcard characters: False
690
+ ` ` `
691
+
545
692
# ## -ThrottleLimit
546
693
547
694
Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If
@@ -612,8 +759,7 @@ Accept wildcard characters: False
612
759
613
760
# ## -WhatIf
614
761
615
- Shows what would happen if the cmdlet runs.
616
- The cmdlet isn't run.
762
+ Shows what would happen if the cmdlet runs. The cmdlet isn't run.
617
763
618
764
` ` ` yaml
619
765
Type: SwitchParameter
@@ -622,7 +768,7 @@ Aliases: wi
622
768
623
769
Required: False
624
770
Position: Named
625
- Default value: None
771
+ Default value: False
626
772
Accept pipeline input: False
627
773
Accept wildcard characters: False
628
774
` ` `
@@ -632,7 +778,7 @@ Accept wildcard characters: False
632
778
This cmdlet supports the common parameters : -Debug, -ErrorAction, -ErrorVariable,
633
779
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
634
780
-WarningAction, and -WarningVariable. For more information, see
635
- [about_CommonParameters](http://go. microsoft.com/fwlink/?LinkID=113216 ).
781
+ [about_CommonParameters](/powershell/module/ microsoft.powershell.core/about/about_commonparameters ).
636
782
637
783
# # INPUTS
638
784
@@ -646,6 +792,6 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
646
792
647
793
# # RELATED LINKS
648
794
649
- [Get-SmbClientConfiguration](./ Get-SmbClientConfiguration.md)
795
+ [Get-SmbClientConfiguration](Get-SmbClientConfiguration.md)
650
796
651
- [Set-SmbClientConfiguration](./ Set-SmbClientConfiguration.md)
797
+ [Set-SmbClientConfiguration](Set-SmbClientConfiguration.md)
0 commit comments