Delen via

New-AzureServiceExtensionConfig

  • Referentie
Module:
Azure

Hiermee maakt u een configuratie van een cloudservice-extensie voor een implementatie.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

New-AzureServiceExtensionConfig
   [[-Role] <String[]>]
   [[-X509Certificate] <X509Certificate2>]
   [[-ThumbprintAlgorithm] <String>]
   [-ExtensionName] <String>
   [-ProviderNamespace] <String>
   [-PublicConfiguration] <String>
   [-PrivateConfiguration] <String>
   [-Version] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureServiceExtensionConfig
   [[-Role] <String[]>]
   [-CertificateThumbprint] <String>
   [[-ThumbprintAlgorithm] <String>]
   [-ExtensionName] <String>
   [-ProviderNamespace] <String>
   [-PublicConfiguration] <String>
   [-PrivateConfiguration] <String>
   [-Version] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureServiceExtensionConfig
   [[-Role] <String[]>]
   [-ExtensionId] <String>
   [-ExtensionState] <String>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

Met de cmdlet New-AzureServiceExtensionConfig maakt u een configuratie van de cloudservice-extensie voor een implementatie.

Voorbeelden

Voorbeeld 1: Een extensieconfiguratie maken

PS C:\> New-AzureServiceExtensionConfig -ExtensionName 'RDP' -Version '1.0' -ProviderNamespace Microsoft.Windows.Azure.Extensions -PublicConfiguration $p1 -PrivateConfiguration $p2;

Met deze opdracht geeft u een extensieconfiguratie op.

Voorbeeld 2: Een extensieconfiguratie voor een rol maken

PS C:\> New-AzureServiceExtensionConfig -Role WebRole1 -ExtensionName 'RDP' -ProviderNamespace Microsoft.Windows.Azure.Extensions -PublicConfiguration $p1 -PrivateConfiguration $p2;

Met deze opdracht geeft u een extensieconfiguratie op voor de rol WebRole1.

Parameters

-CertificateThumbprint

Hiermee geeft u een certificaatvingerafdruk op die moet worden gebruikt om de persoonlijke configuratie te versleutelen. Dit certificaat moet al aanwezig zijn in het certificaatarchief. Als u geen certificaat opgeeft, maakt deze cmdlet een certificaat.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ExtensionId

Hiermee geeft u de naam van de extensie.

Type:String
Position:8
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ExtensionName

Hiermee geeft u de naam van de extensie.

Type:String
Position:3
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ExtensionState

Hiermee geeft u de status van de extensie. De aanvaardbare waarden voor deze parameter zijn:

  • Inschakelen
  • Uitschakelen
  • Verwijderen
Type:String
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De aanvaardbare waarden voor deze parameter zijn:

  • Verdergaan
  • Negeren
  • Vragen
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliassen:infa
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

Type:String
Aliassen:iv
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PrivateConfiguration

Hiermee geeft u de privéconfiguratietekst op.

Type:String
Position:6
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProviderNamespace

Hiermee geeft u de providernaamruimte van de extensie.

Type:String
Position:4
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PublicConfiguration

Hiermee geeft u de openbare configuratietekst.

Type:String
Position:5
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Role

Hiermee geeft u een optionele matrix met rollen op waarvoor de configuratie van extern bureaublad moet worden opgegeven. Als de configuratie van het externe bureaublad niet is opgegeven, wordt deze toegepast als de standaardconfiguratie voor alle rollen.

Type:String[]
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ThumbprintAlgorithm

Hiermee geeft u een hash-algoritme voor vingerafdruk op dat wordt gebruikt met de vingerafdruk om het certificaat te identificeren. Deze parameter is optioneel en de standaardwaarde is sha1.

Type:String
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Version

Hiermee geeft u de extensieversie.

Type:String
Position:7
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-X509Certificate

Hiermee geeft u een x509-certificaat op dat wanneer opgegeven automatisch wordt geüpload naar de cloudservice en wordt gebruikt voor het versleutelen van de persoonlijke configuratie van de extensie.

Type:X509Certificate2
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False