Set-AzureServiceExtension

Referentie

Module:: Azure

Hiermee voegt u een cloudservice-extensie toe aan een implementatie.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van Service Management-API's. Zie de Az PowerShell-module voor cmdlets voor het beheren van Azure Resource Manager-resources.

Belangrijk

Cloud Services (klassiek) is nu afgeschaft voor nieuwe klanten en wordt op 31 augustus 2024 buiten gebruik gesteld voor alle klanten. Nieuwe implementaties moeten gebruikmaken van het nieuwe op Azure Resource Manager gebaseerde implementatiemodel Azure Cloud Services (uitgebreide ondersteuning).

Syntax

Set-AzureServiceExtension
   [[-ServiceName] <String>]
   [[-Slot] <String>]
   [[-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>]

Set-AzureServiceExtension
   [[-ServiceName] <String>]
   [[-Slot] <String>]
   [[-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>]

Description

De cmdlet Set-AzureServiceExtension voegt een cloudservice-extensie toe aan een implementatie.

Voorbeelden

Voorbeeld 1: Een cloudservice toevoegen aan een implementatie

PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -ExtensionName "RDP" -Version "1.0" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;

Met deze opdracht wordt een cloudservice toegevoegd aan een implementatie.

Voorbeeld 2: Een cloudservice toevoegen aan een implementatie voor een opgegeven rol

PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -Role "WebRole1" -ExtensionName "RDP" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;

Met deze opdracht wordt een cloudservice toegevoegd aan een implementatie voor een opgegeven rol.

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:	3
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ExtensionId

Hiermee geeft u de extensie-id.

Type:	String
Position:	10
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ExtensionName

Hiermee geeft u de extensienaam.

Type:	String
Position:	5
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InformationAction

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

De acceptabele waarden voor deze parameter zijn:

Doorgaan
Negeren
Informeren
SilentlyContinue
Stoppen
Onderbreken

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Hiermee geeft u een informatievariabele op.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrivateConfiguration

Hiermee geeft u de privéconfiguratietekst op.

Type:	String
Position:	8
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProviderNamespace

Hiermee geeft u de extensieprovidernaamruimte.

Type:	String
Position:	6
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PublicConfiguration

Hiermee geeft u de openbare configuratietekst.

Type:	String
Position:	7
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Role

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

Type:	String[]
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ServiceName

Hiermee geeft u de Azure-servicenaam van de implementatie op.

Type:	String
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Slot

Hiermee geeft u de omgeving van de implementatie die moet worden gewijzigd. Geldige waarden zijn: Productie of Fasering.

Type:	String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ThumbprintAlgorithm

Hiermee geeft u het 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:	4
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Version

Hiermee geeft u de extensieversie.

Type:	String
Position:	9
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-X509Certificate

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

Type:	X509Certificate2
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False