Freigeben über

New-AzureCertificateSetting

  • Referenz
Modul:
Azure

Erstellt ein Zertifikateinstellungsobjekt für ein Zertifikat in einem Dienst.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Wichtig

Cloud Services (klassisch) wurde für neue Kunden nun als veraltet gekennzeichnet und wird am 31. August 2024 für alle Kunden ausgemustert. In neuen Bereitstellungen sollte das neue auf Azure Resource Manager basierende Bereitstellungsmodell für Azure Cloud Services (erweiterter Support) verwendet werden.

Syntax

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

Beschreibung

Das Cmdlet New-AzureCertificateSetting erstellt ein Zertifikateinstellungsobjekt für ein Zertifikat, das sich in einem Azure-Dienst befindet.

Sie können ein Zertifikateinstellungsobjekt verwenden, um ein Konfigurationsobjekt mithilfe des Cmdlets "Add-AzureProvisioningConfig " zu erstellen. Verwenden Sie ein Konfigurationsobjekt zum Erstellen eines virtuellen Computers mithilfe des Cmdlets New-AzureVM . Sie können ein Zertifikateinstellungsobjekt verwenden, um einen virtuellen Computer mithilfe des Cmdlets New-AzureQuickVM zu erstellen.

Beispiele

Beispiel 1: Erstellen eines Zertifikateinstellungsobjekts

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

Mit diesem Befehl wird ein Zertifikateinstellungsobjekt für ein vorhandenes Zertifikat erstellt.

Beispiel 2: Erstellen eines virtuellen Computers, der ein Konfigurationseinstellungsobjekt verwendet

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"

Mit dem ersten Befehl wird das Zertifikat ContosoCert.cer dem Dienst "ContosoService" mithilfe des Cmdlets "Add-AzureCertificate " hinzugefügt.

Der zweite Befehl erstellt ein Zertifikateinstellungsobjekt und speichert es dann in der $CertificateSetting Variablen.

Der dritte Befehl ruft ein Bild aus dem Image-Repository mithilfe des Cmdlets "Get-AzureVMImage " ab. Mit diesem Befehl wird das Bild in der variablen $Image gespeichert.

Der letzte Befehl erstellt ein Konfigurationsobjekt für virtuelle Computer basierend auf dem Image in $Image mithilfe des Cmdlets New-AzureVMConfig . Der Befehl übergibt dieses Objekt mithilfe des Pipelineoperators an das Cmdlet "Add-AzureProvisioningConfig ". Dieses Cmdlet fügt der Konfiguration Bereitstellungsinformationen hinzu. Der Befehl übergibt das Objekt an das New-AzureVM-Cmdlet , das den virtuellen Computer erstellt.

Parameter

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StoreName

Gibt den Zertifikatspeicher an, in dem das Zertifikat abgelegt werden soll. Gültige Werte sind:

  • Adressbuch
  • AuthRoot
  • CertificateAuthority
  • Unzulässig
  • My
  • Root
  • TrustedPeople
  • TrustedPublisher
Typ:String
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Thumbprint

Gibt den Fingerabdruck des Zertifikats an.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False