Skip to main content

Register-FMCertificate

SYNOPSIS

Register directory services certificates

SYNTAX

Certificate

Register-FMCertificate -Type <string> -Certificate <X509Certificate2> [-ContextName <string>]
[<CommonParameters>]

Authorative

Register-FMCertificate -Type <string> -Authorative <bool> [-ContextName <string>]
[<CommonParameters>]

Remove

Register-FMCertificate -Type <string> -Remove <string> [-ContextName <string>] [<CommonParameters>]

DESCRIPTION

Register directory services certificates

EXAMPLES

EXAMPLE 1

Register-FMCertificate -Certificate $certificate -Type RootCA

Register a certiciate as RootCA certificate.

EXAMPLE 2

Register-FMCertificate -Authorative -Type RootCA

Sets our current configuration as authorative, removing all non-listed certificates from the store.

EXAMPLE 3

Register-FMCertificate -Remove $cert.Thumbprint -Type SubCA

Registers a certificate for removal from the SubCA list.

PARAMETERS

-Authorative

Should the certificate configuration overwrite the existing configuration, rather than adding to it (default).

Type: System.Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Authorative
Position: Named
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Certificate

The certifcate to apply.

Type: System.Security.Cryptography.X509Certificates.X509Certificate2
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Certificate
Position: Named
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ContextName

The name of the context defining the setting. This allows determining the configuration set that provided this setting. Used by the ADMF, available to any other configuration management solution.

Type: System.String
DefaultValue: <Undefined>
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Remove

Thumbprint of a certificate to remove rather than add.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Remove
Position: Named
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Type

The kind of certificate this is. Can be: NTAuthCA, RootCA, SubCA, CrossCA or KRA.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

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.