Get-KdsConfiguration

Get-KdsConfiguration

Retrieves the current configuration of the Microsoft Group Key Distribution Service (KdsSvc) from Active Directory (AD).

Syntax

Get-KdsConfiguration [ <CommonParameters>]

Detailed Description

The Get-KdsConfiguration cmdlet retrieves the current configuration of the Microsoft Group Key Distribution Service (KdsSvc) from Active Directory (AD). The KDS configuration defines how keys are generated from the root keys.

Parameters

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • None

    This cmdlet accepts no input objects.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.KeyDistributionService.KdsServerConfiguration

    A KdsServerConfiguration object contains information such as the key derivation function (KDF) algorithm and secret agreement algorithm used in key generation.

Examples

Example 1: Retrieve the current KDS configuration

This example retrieves the current configuration of the Microsoft Group KdsSvc from AD.

PS C:\> Get-KdsConfiguration

Add-KdsRootKey

Clear-KdsCache

Get-KdsRootKey

Set-KdsConfiguration

Test-KdsRootKey