Update-AdfsCertificate
Update-AdfsCertificate
Updates the certificates of AD FS.
Syntaxe
Parameter Set: Default
Update-AdfsCertificate [[-CertificateType] <String> ] [-PassThru] [-Urgent] [-Confirm] [-WhatIf] [ <CommonParameters>]
Description détaillée
The Update-AdfsCertificate cmdlet creates new certificates for services de fédération Active Directory (AD FS). When automatic certificate rollover is enabled and AD FS 2.0 is managing the certificates that are used for signing, this update cmdlet can be used to initiate a rollover.
Paramètres
-CertificateType<String>
Specifies the type of certificate to rollover. Les valeurs acceptables pour ce paramètre sont :
-- Token-Encryption
-- Token-Signing
Alias |
none |
Obligatoire ? |
false |
Position ? |
1 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-PassThru
Retourne un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucun résultat.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Urgent
Indicates that the certificate rollover should happen immediately. An urgent rollover removes older certificates immediately. It might result in a service outage as trusts update to use the new certificates.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Confirm
Votre confirmation sera requise avant l’exécution de l’applet de commande.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
false |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-WhatIf
Présente les conséquences éventuelles de l’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
false |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.
- None
Sorties
Le type de sortie est le type des objets émis par l’applet de commande.
- None
Remarques
- The Urgent parameter option is useful for emergency rollover situations in which a key might be compromised.
Exemples
Example 1: Update a token-signing certificate
This command updates the token-signing certificate.
PS C:\> Update-AdfsCertificate -CertificateType "Token-Signing"