Enable-TlsSessionTicketKey
Enable-TlsSessionTicketKey
Configures a TLS server with a TLS session ticket key.
语法
Parameter Set: Default
Enable-TlsSessionTicketKey [-Password] <SecureString> [-Path] <String> [-ServiceAccountName] <NTAccount> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
详细说明
The Enable-TlsSessionTicketKey cmdlet configures a Transport Layer Security (TLS) server with an administrator-managed TLS session ticket key, and configures the rule that uses the key for the application service account.
TLS creates a session ticket by using the Transport Layer Security (TLS) Session Resumption without Server-Side State mechanism [RFC 5077]. This mechanism helps to improve the performance of TLS. The TLS server uses this mechanism to create a key to encrypt a session ticket. The client can later use the encrypted session ticket to resume communication with the TLS server. Otherwise, the client must restart the communication by acquiring a new session ticket. For more information, see RFC 5077, "Transport Layer Security (TLS) Session Resumption without Server-Side State."
参数
-Force
在不请求用户确认的情况下，强制该命令运行。
If you specify this parameter, the cmdlet overwrites the existing session ticket key and configuration.
别名 |
无 |
是否为必需？ |
false |
位置？ |
named |
默认值 |
无 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-Password<SecureString>
Specifies the password, as a secure string, for the configuration file of the TLS server.
别名 |
无 |
是否为必需？ |
true |
位置？ |
1 |
默认值 |
无 |
是否接受管道输入？ |
True (ByValue, ByPropertyName) |
是否接受通配符？ |
false |
-Path<String>
Specifies the path of the configuration file for the TLS server.
别名 |
FullName |
是否为必需？ |
true |
位置？ |
2 |
默认值 |
无 |
是否接受管道输入？ |
True (ByPropertyName) |
是否接受通配符？ |
false |
-ServiceAccountName<NTAccount>
Specifies the name of a service account. The cmdlet configures the TLS session ticket key for the service account.
别名 |
无 |
是否为必需？ |
true |
位置？ |
3 |
默认值 |
无 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-Confirm
运行 cmdlet 之前提示你进行确认。
是否为必需？ |
false |
位置？ |
named |
默认值 |
false |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-WhatIf
显示如果运行 cmdlet 则会发生什么情况。cmdlet 未运行。
是否为必需？ |
false |
位置？ |
named |
默认值 |
false |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
<CommonParameters>
此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
输入
输入类型是指可通过管道传送给 cmdlet 的对象的类型。
输出
输出类型是 cmdlet 所发出对象的类型。
示例
Example 1: Configure a TLS server with a TLS session ticket key
This example configures a TLS server with a key for the TLS session ticket.
The first command prompts the user to enter a password. The command masks the password that the user types at the prompt. The command stores the password in the $Password variable
The second command configures the session ticket key for the TLS server. The command specifies the path for the configuration file on the TLS server, and specifies that the TLS session use the password stored in $Password to access the configuration file.
PS C:\> $Password = read-host -assecurestring
PS C:\> Enable-TlsSessionTicketKey -Path "C:\keyconfig\tlssessionticketKey.config" -Password $Password -ServiceAccountName "Networkservice"