Partager via


New-AzureCertificateSetting

Crée un objet de paramètre de certificat pour un certificat dans un service.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Important

Services Cloud (classique) est désormais déconseillé pour les nouveaux clients et sera supprimé le 31 août 2024 pour tous les clients. Les nouveaux déploiements doivent utiliser le nouveau modèle de déploiement basé sur Azure Resource Manager Azure Cloud Services (support étendu) .

Syntaxe

New-AzureCertificateSetting
   [[-StoreName] <String>]
   [-Thumbprint] <String>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande New-AzureCertificateSetting crée un objet de paramètre de certificat pour un certificat qui se trouve dans un service Azure.

Vous pouvez utiliser un objet de paramètre de certificat pour créer un objet de configuration à l’aide de l’applet de commande Add-AzureProvisioningConfig . Utilisez un objet de configuration pour créer une machine virtuelle à l’aide de l’applet de commande New-AzureVM . Vous pouvez utiliser un objet de paramètre de certificat pour créer une machine virtuelle à l’aide de l’applet de commande New-AzureQuickVM .

Exemples

Exemple 1 : Créer un objet de paramètre de certificat

PS C:\> New-AzureCertificateSetting -Thumbprint "D7BECD4D63EBAF86023BB41FA5FBF5C2C924902A" -StoreName "My"

Cette commande crée un objet de paramètre de certificat pour un certificat existant.

Exemple 2 : Créer une machine virtuelle qui utilise un objet de paramètre de configuration

PS C:\> Add-AzureCertificate -ServiceName "ContosoService" -CertToDeploy "C:\temp\ContosoCert.cer"
PS C:\> $CertificateSetting = New-AzureCertificateSetting -Thumbprint "D7BECD4D63EBAF86023BB41FA5FBF5C2C924902A" -StoreName "My" 
PS C:\> $Image = Get-AzureVMImage -ImageName "ContosoStandard"
PS C:\> New-AzureVMConfig -Name "VirtualMachine17" -InstanceSize Small -ImageName $Image | Add-AzureProvisioningConfig -Windows -Certificates $CertificateSetting -Password "password" | New-AzureVM -ServiceName "ContosoService"

La première commande ajoute le certificat ContosoCert.cer au service nommé ContosoService à l’aide de l’applet de commande Add-AzureCertificate .

La deuxième commande crée un objet de paramètre de certificat, puis le stocke dans la variable $CertificateSetting.

La troisième commande obtient une image à partir du référentiel d’images à l’aide de l’applet de commande Get-AzureVMImage . Cette commande stocke l’image dans la variable $Image.

La commande finale crée un objet de configuration de machine virtuelle basé sur l’image dans $Image à l’aide de l’applet de commande New-AzureVMConfig . La commande transmet cet objet à l’applet de commande Add-AzureProvisioningConfig à l’aide de l’opérateur de pipeline. Cette applet de commande ajoute des informations d’approvisionnement à la configuration. La commande transmet l’objet à l’applet de commande New-AzureVM , qui crée la machine virtuelle.

Paramètres

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Demander
  • SilentlyContinue
  • Stop
  • Suspendre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

Type:String
Alias:iv
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-StoreName

Spécifie le magasin de certificats dans lequel placer le certificat. Les valeurs valides sont :

  • AddressBook
  • AuthRoot
  • CertificateAuthority
  • Disallowed
  • My
  • Root
  • TrustedPeople
  • TrustedPublisher
Type:String
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Thumbprint

Spécifie l'empreinte numérique du certificat.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False