Edit

Share via


Get-SmbServerCertProps

Retrieves an SMB over QUIC-mapped certificate’s properties and tests certificate validity.

Syntax

Default (Default)

Get-SmbServerCertProps
    -`-Name` <String>
    -`-Force` <CommonParameters>
    [<CommonParameters>]

Description

The Get-SmbServerCertProps cmdlet retrieves the properties of a certificate associated with the SMB server for SMB over QUIC on Windows Server 2022 Datacenter: Azure Edition. It also tests the validity of the certificate. This cmdlet is not used for Windows or other Windows Server editions. For more information, review SMB over QUIC.

Examples

Example 1 - Retrieve the properties of a certificate associated with the SMB server

This command retrieves the properties and validity of the 2022-ae-02.corp.contoso.com SMB over QUIC endpoint certificate mapping.

PS C:\> Get-SmbServerCertProps `-Name` 2022-ae-02.corp.contoso.com
Checking Mapping '2022-ae-02.corp.contoso.com'.....
SMBServerCertificateMappingName : 2022-ae-02.corp.contoso.com
SelfSigned                      : True
SubjectName                     : System.Security.Cryptography.X509Certificates.X500DistinguishedName
Subject                         : CN=2022-ae-02
SubjectOid                      : System.Security.Cryptography.Oid
SubjectRawData                  : {48, 21, 49, 19...}
FriendlyName                    :
SignatureAlgorithm              : 1.2.840.113549.1.1.11 sha256RSA
Thumbprint                      : 88032B3551FAF7DE26EFFFF814AA086E3DBD2A4F
NotBefore                       : 8/20/2021 3:02:16 PM
NotAfter                        : 8/20/2022 3:02:16 PM
SendAsTrustedIssuer             : False
PublicKey                       : System.Security.Cryptography.X509Certificates.PublicKey
DnsNameList                     : {2022-ae-02.corp.contoso.com, fs2.contoso.com}

Test-Certificate result : PASS

RenewalChain:

Testing certificates in the RenewalChain.....

Parameters

-Force

Forces the command to run without asking for user confirmation.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies a fully-qualified DNS name or NetBIOS name that must match the certificate’s subject name or an entry in the certificate’s subject alternative names.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

Object