Bagikan melalui


Set-AzureServiceExtension

Menambahkan ekstensi layanan cloud ke penyebaran.

Catatan

Cmdlet yang dirujuk dalam dokumentasi ini adalah untuk mengelola sumber daya Azure warisan yang menggunakan API Azure Service Manager (ASM). Modul PowerShell warisan ini tidak disarankan saat membuat sumber daya baru karena ASM dijadwalkan untuk dihentikan. Untuk informasi selengkapnya, lihat Penghentian Azure Service Manager.

Modul Az PowerShell adalah modul PowerShell yang direkomendasikan untuk mengelola sumber daya Azure Resource Manager (ARM) dengan PowerShell.

Penting

Cloud Services (klasik) sekarang tidak lagi digunakan untuk pelanggan baru dan akan dihentikan untuk semua pelanggan pada 31 Agustus 2024. Penyebaran baru sebaiknya menggunakan Azure Resource Manager yang baru berdasarkan model penyebaran Azure Cloud Services (dukungan tambahan).

Sintaks

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>]

Deskripsi

Cmdlet Set-AzureServiceExtension menambahkan ekstensi layanan cloud ke penyebaran.

Contoh

Contoh 1: Menambahkan layanan cloud ke penyebaran

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

Perintah ini menambahkan layanan cloud ke penyebaran.

Contoh 2: Menambahkan layanan awan ke penyebaran untuk peran tertentu

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

Perintah ini menambahkan layanan cloud ke penyebaran untuk peran tertentu.

Parameter

-CertificateThumbprint

Menentukan thumbprint sertifikat yang akan digunakan untuk mengenkripsi konfigurasi privat. Sertifikat ini harus sudah ada di penyimpanan sertifikat. Jika Anda tidak menentukan sertifikat, cmdlet ini akan membuat sertifikat.

Jenis:String
Position:3
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ExtensionId

Menentukan ID ekstensi.

Jenis:String
Position:10
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ExtensionName

Menentukan nama ekstensi.

Jenis:String
Position:5
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-InformationAction

Menentukan bagaimana cmdlet ini merespons peristiwa informasi.

Nilai yang dapat diterima untuk parameter ini adalah:

  • Lanjutkan
  • Abaikan
  • Tanya
  • Lanjutkan Diam-diam
  • Stop
  • Tangguhkan
Jenis:ActionPreference
Alias:infa
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-InformationVariable

Menentukan variabel informasi.

Jenis:String
Alias:iv
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-PrivateConfiguration

Menentukan teks konfigurasi privat.

Jenis:String
Position:8
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Profile

Menentukan profil Azure tempat cmdlet ini dibaca. Jika Anda tidak menentukan profil, cmdlet ini akan membaca dari profil default lokal.

Jenis:AzureSMProfile
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ProviderNamespace

Menentukan namespace penyedia ekstensi.

Jenis:String
Position:6
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-PublicConfiguration

Menentukan teks konfigurasi publik.

Jenis:String
Position:7
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Role

Menentukan array peran opsional untuk menentukan konfigurasi desktop jarak jauh. Jika parameter ini tidak ditentukan, konfigurasi desktop jarak jauh diterapkan sebagai konfigurasi default untuk semua peran.

Jenis:String[]
Position:2
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ServiceName

Menentukan nama layanan Azure dari penyebaran.

Jenis:String
Position:0
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Slot

Menentukan lingkungan penyebaran yang akan diubah. Nilai yang valid adalah: Produksi atau Penahapan.

Jenis:String
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ThumbprintAlgorithm

Menentukan algoritma hash thumbprint yang digunakan dengan thumbprint untuk mengidentifikasi sertifikat. Parameter ini bersifat opsional dan defaultnya adalah sha1.

Jenis:String
Position:4
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Version

Menentukan versi ekstensi.

Jenis:String
Position:9
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-X509Certificate

Menentukan sertifikat X.509 yang secara otomatis diunggah ke layanan cloud dan digunakan untuk mengenkripsi konfigurasi privat ekstensi.

Jenis:X509Certificate2
Position:3
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False