Skip to content

Commit 4f390dd

Browse files
Merge pull request MicrosoftDocs#3346 from thedavecarroll/3323/tls
Quality: PowerShell Summit MicrosoftDocsGH-3323
2 parents a90bcdf + d4b8806 commit 4f390dd

11 files changed

+315
-181
lines changed

docset/winserver2022-ps/tls/Disable-TlsCipherSuite.md

Lines changed: 19 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -20,16 +20,19 @@ Disable-TlsCipherSuite [-Name] <String> [-WhatIf] [-Confirm] [<CommonParameters>
2020
```
2121

2222
## DESCRIPTION
23-
The **Disable-TlsCipherSuite** cmdlet disables a cipher suite.
24-
This cmdlet removes the cipher suite from the list of Transport Layer Security (TLS) protocol cipher suites for the computer.
2523

26-
For more information about the TLS cipher suites, see the documentation for the Enable-TlsCipherSuite cmdlet or type `Get-Help Enable-TlsCipherSuite`.
24+
The `Disable-TlsCipherSuite` cmdlet disables a cipher suite. This cmdlet removes the cipher suite
25+
from the list of Transport Layer Security (TLS) protocol cipher suites for the computer.
26+
27+
For more information about the TLS cipher suites, see the documentation for the
28+
Enable-TlsCipherSuite cmdlet or type `Get-Help Enable-TlsCipherSuite`.
2729

2830
## EXAMPLES
2931

3032
### Example 1: Disable a cipher suite
31-
```
32-
PS C:\>Disable-TlsCipherSuite -Name "TLS_RSA_WITH_3DES_EDE_CBC_SHA"
33+
34+
```powershell
35+
Disable-TlsCipherSuite -Name 'TLS_RSA_WITH_3DES_EDE_CBC_SHA'
3336
```
3437

3538
This command disables the cipher suite named TLS_RSA_WITH_3DES_EDE_CBC_SHA.
@@ -38,12 +41,13 @@ The command removes the cipher suite from the list of TLS protocol cipher suites
3841
## PARAMETERS
3942

4043
### -Name
44+
4145
Specifies the name of the TLS cipher suite to disable.
4246

4347
```yaml
44-
Type: String
48+
Type: System.String
4549
Parameter Sets: (All)
46-
Aliases:
50+
Aliases:
4751

4852
Required: True
4953
Position: 1
@@ -53,10 +57,11 @@ Accept wildcard characters: False
5357
```
5458
5559
### -Confirm
60+
5661
Prompts you for confirmation before running the cmdlet.
5762
5863
```yaml
59-
Type: SwitchParameter
64+
Type: System.Management.Automation.SwitchParameter
6065
Parameter Sets: (All)
6166
Aliases: cf
6267

@@ -68,10 +73,11 @@ Accept wildcard characters: False
6873
```
6974
7075
### -WhatIf
76+
7177
Shows what would happen if the cmdlet runs. The cmdlet is not run.
7278
7379
```yaml
74-
Type: SwitchParameter
80+
Type: System.Management.Automation.SwitchParameter
7581
Parameter Sets: (All)
7682
Aliases: wi
7783

@@ -83,7 +89,10 @@ Accept wildcard characters: False
8389
```
8490
8591
### CommonParameters
86-
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
92+
93+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
94+
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
95+
-WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
8796
8897
## INPUTS
8998
@@ -96,4 +105,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
96105
[Enable-TlsCipherSuite](./Enable-TlsCipherSuite.md)
97106
98107
[Get-TlsCipherSuite](./Get-TlsCipherSuite.md)
99-

docset/winserver2022-ps/tls/Disable-TlsEccCurve.md

Lines changed: 21 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,8 @@ title: Disable-TlsEccCurve
1111
# Disable-TlsEccCurve
1212

1313
## SYNOPSIS
14-
Disables the Elliptic Curve Cryptography (ECC) cipher suites available for TLS(Transport Layer Security) for a computer.
14+
Disables the Elliptic Curve Cryptography (ECC) cipher suites available for TLS(Transport Layer
15+
Security) for a computer.
1516

1617
## SYNTAX
1718

@@ -20,26 +21,30 @@ Disable-TlsEccCurve [-Name] <String> [-WhatIf] [-Confirm] [<CommonParameters>]
2021
```
2122

2223
## DESCRIPTION
23-
This Command disables the Elliptic Curve Cryptography (ECC) cipher suites available for TLS(Transport Layer Security) for a computer.
24+
25+
This Command disables the Elliptic Curve Cryptography (ECC) cipher suites available for
26+
TLS(Transport Layer Security) for a computer.
2427

2528
## EXAMPLES
2629

2730
### Example 1
28-
```
29-
PS C:\> Disable-TlsEccCurve -Name curve25519
31+
32+
```powershell
33+
Disable-TlsEccCurve -Name curve25519
3034
```
3135

32-
This will disable the ECC Curve "curve25519".
36+
This will disable the ECC Curve `curve25519`.
3337

3438
## PARAMETERS
3539

3640
### -Name
41+
3742
Specifies the name of the ECC curve to disable.
3843

3944
```yaml
40-
Type: String
45+
Type: System.String
4146
Parameter Sets: (All)
42-
Aliases:
47+
Aliases:
4348

4449
Required: True
4550
Position: 0
@@ -49,10 +54,11 @@ Accept wildcard characters: False
4954
```
5055
5156
### -Confirm
57+
5258
Prompts you for confirmation before running the cmdlet.
5359
5460
```yaml
55-
Type: SwitchParameter
61+
Type: System.Management.Automation.SwitchParameter
5662
Parameter Sets: (All)
5763
Aliases: cf
5864

@@ -64,11 +70,12 @@ Accept wildcard characters: False
6470
```
6571
6672
### -WhatIf
73+
6774
Shows what would happen if the cmdlet runs.
6875
The cmdlet is not run.
6976
7077
```yaml
71-
Type: SwitchParameter
78+
Type: System.Management.Automation.SwitchParameter
7279
Parameter Sets: (All)
7380
Aliases: wi
7481

@@ -80,18 +87,20 @@ Accept wildcard characters: False
8087
```
8188
8289
### CommonParameters
83-
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
90+
91+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
92+
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
93+
-WarningAction, and -WarningVariable. For more information, see
94+
[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
8495
8596
## INPUTS
8697
8798
### System.String
8899
89-
90100
## OUTPUTS
91101
92102
### System.Object
93103
94104
## NOTES
95105
96106
## RELATED LINKS
97-

docset/winserver2022-ps/tls/Disable-TlsSessionTicketKey.md

Lines changed: 25 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -20,36 +20,42 @@ Disable-TlsSessionTicketKey [-ServiceAccountName] <NTAccount> [-WhatIf] [-Confir
2020
```
2121

2222
## DESCRIPTION
23-
The **Disable-TlsSessionTicketKey** cmdlet disables an administrator managed Transport Layer Security (TLS) session ticket key for the service account.
24-
The cmdlet disables the key for the TLS session by deleting the key and the corresponding rule that uses the key.
2523

26-
When you disable a TLS session ticket key for the service account, the service account cannot decrypt existing TLS session tickets.
27-
Disabling the TLS session ticket key can affect the performance of the TLS server.
28-
The TLS server cannot create new session tickets and must negotiate session information between the client and the server every time the client connects to the TLS server.
24+
The `Disable-TlsSessionTicketKey` cmdlet disables an administrator managed Transport Layer
25+
Security (TLS) session ticket key for the service account. The cmdlet disables the key for the TLS
26+
session by deleting the key and the corresponding rule that uses the key.
27+
28+
When you disable a TLS session ticket key for the service account, the service account cannot
29+
decrypt existing TLS session tickets. Disabling the TLS session ticket key can affect the
30+
performance of the TLS server. The TLS server cannot create new session tickets and must negotiate
31+
session information between the client and the server every time the client connects to the TLS
32+
server.
2933

3034
TLS creates a session ticket by using the TLS Session Resumption without Server-Side State mechanism.
31-
For more information, see New-TlsSessionTicketKey or type `Get-Help New-TlsSessionTicketKey`.
35+
For more information, see `New-TlsSessionTicketKey` or type `Get-Help New-TlsSessionTicketKey`.
3236

3337
## EXAMPLES
3438

35-
### Example 1: Disable a TLS session ticket key.
36-
```
37-
PS C:\> Disable-TlsSessionTicketKey -ServiceAccountName "NetworkService"
39+
### Example 1: Disable a TLS session ticket key
40+
41+
```powershell
42+
Disable-TlsSessionTicketKey -ServiceAccountName NetworkService
3843
```
3944

4045
This command disables the TLS session ticket key for the service account named NetworkService.
4146

4247
## PARAMETERS
4348

4449
### -ServiceAccountName
50+
4551
Specifies the name of a service account.
4652
The cmdlet disables the TLS session ticket key for the service account.
4753
Only System, LocalService, NetworkService, and SID of virtual accounts are supported.
4854

4955
```yaml
50-
Type: NTAccount
56+
Type: System.Security.Principal.NTAccount
5157
Parameter Sets: (All)
52-
Aliases:
58+
Aliases:
5359

5460
Required: True
5561
Position: 1
@@ -59,10 +65,11 @@ Accept wildcard characters: False
5965
```
6066
6167
### -Confirm
68+
6269
Prompts you for confirmation before running the cmdlet.
6370
6471
```yaml
65-
Type: SwitchParameter
72+
Type: System.Management.Automation.SwitchParameter
6673
Parameter Sets: (All)
6774
Aliases: cf
6875

@@ -74,11 +81,12 @@ Accept wildcard characters: False
7481
```
7582
7683
### -WhatIf
84+
7785
Shows what would happen if the cmdlet runs.
7886
The cmdlet is not run.
7987
8088
```yaml
81-
Type: SwitchParameter
89+
Type: System.Management.Automation.SwitchParameter
8290
Parameter Sets: (All)
8391
Aliases: wi
8492

@@ -90,7 +98,10 @@ Accept wildcard characters: False
9098
```
9199
92100
### CommonParameters
93-
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
101+
102+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
103+
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
104+
-WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
94105
95106
## INPUTS
96107
@@ -105,4 +116,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
105116
[New-TlsSessionTicketKey](./New-TlsSessionTicketKey.md)
106117
107118
[Export-TlsSessionTicketKey](./Export-TlsSessionTicketKey.md)
108-

0 commit comments

Comments
 (0)