Set-AzureServiceExtension
Lägger till ett molntjänsttillägg till en distribution.
Kommentar
De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.
Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med PowerShell.
Viktigt!
Cloud Services (klassisk) är nu inaktuellt för nya kunder och kommer att dras tillbaka den 31 augusti 2024 för alla kunder. Nya distributioner bör använda den nya Azure Resource Manager-baserade distributionsmodellen Azure Cloud Services (utökad support).
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
Cmdleten Set-AzureServiceExtension lägger till ett molntjänsttillägg till en distribution.
Exempel
Exempel 1: Lägga till en molntjänst i en distribution
PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -ExtensionName "RDP" -Version "1.0" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;Det här kommandot lägger till en molntjänst i en distribution.
Exempel 2: Lägga till en molntjänst i en distribution för en angiven roll
PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -Role "WebRole1" -ExtensionName "RDP" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;Det här kommandot lägger till en molntjänst i en distribution för en angiven roll.
Parametrar
-CertificateThumbprint
Anger ett tumavtryck för certifikat som ska användas för att kryptera den privata konfigurationen. Certifikatet måste redan finnas i certifikatarkivet. Om du inte anger något certifikat skapar den här cmdleten ett certifikat.
| Typ: | String |
| Position: | 3 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ExtensionId
Anger tilläggs-ID:t.
| Typ: | String |
| Position: | 10 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ExtensionName
Anger tilläggets namn.
| Typ: | String |
| Position: | 5 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-InformationAction
Anger hur den här cmdleten svarar på en informationshändelse.
De acceptabla värdena för den här parametern är:
- Fortsätt
- Ignorera
- Fråga
- TystKontinuera
- Stoppa
- Suspend
| Typ: | ActionPreference |
| Alias: | infa |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-InformationVariable
Anger en informationsvariabel.
| Typ: | String |
| Alias: | iv |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-PrivateConfiguration
Anger den privata konfigurationstexten.
| Typ: | String |
| Position: | 8 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Profile
Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.
| Typ: | AzureSMProfile |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ProviderNamespace
Anger namnområdet för tilläggsprovidern.
| Typ: | String |
| Position: | 6 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-PublicConfiguration
Anger den offentliga konfigurationstexten.
| Typ: | String |
| Position: | 7 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Role
Anger en valfri matris med roller som du vill ange fjärrskrivbordskonfigurationen för. Om den här parametern inte anges tillämpas fjärrskrivbordskonfigurationen som standardkonfiguration för alla roller.
| Typ: | String[] |
| Position: | 2 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ServiceName
Anger Azure-tjänstnamnet för distributionen.
| Typ: | String |
| Position: | 0 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Slot
Anger den miljö för distributionen som ska ändras. Giltiga värden är: Produktion eller mellanlagring.
| Typ: | String |
| Position: | 1 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ThumbprintAlgorithm
Anger algoritmen för tumavtryckshashing som används med tumavtrycket för att identifiera certifikatet. Den här parametern är valfri och standardvärdet är sha1.
| Typ: | String |
| Position: | 4 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Version
Anger tilläggsversionen.
| Typ: | String |
| Position: | 9 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-X509Certificate
Anger ett X.509-certifikat som automatiskt laddas upp till molntjänsten och används för att kryptera tilläggets privata konfiguration.
| Typ: | X509Certificate2 |
| Position: | 3 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |