Saran dan Komentar

Update-AzConnectedMachineExtension

  • Referensi
Modul:
Az.ConnectedMachine

Operasi untuk membuat atau memperbarui ekstensi.

Sintaks

Update-AzConnectedMachineExtension
      -MachineName <String>
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-AutoUpgradeMinorVersion]
      [-EnableAutomaticUpgrade]
      [-ForceRerun <String>]
      [-ProtectedSetting <Hashtable>]
      [-Publisher <String>]
      [-Setting <Hashtable>]
      [-Tag <Hashtable>]
      [-Type <String>]
      [-TypeHandlerVersion <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]
Update-AzConnectedMachineExtension
      -MachineName <String>
      -Name <String>
      -ResourceGroupName <String>
      -ExtensionParameter <IMachineExtensionUpdate>
      [-SubscriptionId <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]
Update-AzConnectedMachineExtension
      -InputObject <IConnectedMachineIdentity>
      -ExtensionParameter <IMachineExtensionUpdate>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]
Update-AzConnectedMachineExtension
      -InputObject <IConnectedMachineIdentity>
      [-AutoUpgradeMinorVersion]
      [-EnableAutomaticUpgrade]
      [-ForceRerun <String>]
      [-ProtectedSetting <Hashtable>]
      [-Publisher <String>]
      [-Setting <Hashtable>]
      [-Tag <Hashtable>]
      [-Type <String>]
      [-TypeHandlerVersion <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Deskripsi

Operasi untuk membuat atau memperbarui ekstensi.

Contoh

Contoh 1: Memperbarui ekstensi

$splat = @{
            ResourceGroupName = "connectedMachines"
            MachineName = "linux-eastus1_1"
            Name = "customScript"
            Settings = @{
                commandToExecute = "ls -l"
            }
        }
Update-AzConnectedMachineExtension @splat

Name         Location ProvisioningState
----         -------- -----------------
customScript eastus   Succeeded

Updates ekstensi pada komputer tertentu.

Contoh 2: Memperbarui ekstensi dengan lokasi yang ditentukan melalui alur

$extToUpdate = Get-AzConnectedMachineExtension -ResourceGroupName connectedMachines -MachineName linux-eastus1_1 -Name customScript
$extToUpdate | Update-AzConnectedMachineExtension -Settings @{
                commandToExecute = "ls -l"
            }

Name         Location ProvisioningState
----         -------- -----------------
customScript eastus   Succeeded

Updates ekstensi tertentu yang diteruskan melalui alur. Di sini kita menggunakan ekstensi yang diteruskan melalui alur untuk membantu kita mengidentifikasi ekstensi mana yang ingin kita operasikan dan menentukan apa yang ingin kita ubah melalui parameter normal (seperti -Settings)

Contoh 3: Memperbarui ekstensi dengan parameter ekstensi yang ditentukan melalui alur

$extToUpdate = Get-AzConnectedMachineExtension -ResourceGroupName connectedMachines -MachineName linux-eastus1_1 -Name customScript
# Update the settings on the object that will be used via the pipeline
$extToUpdate.Setting.commandToExecute = "ls -l"
$splat = @{
            ResourceGroupName = "connectedMachines"
            MachineName = "linux-eastus1_1"
            Name = "customScript"
        }
$extToUpdate | Update-AzConnectedMachineExtension @splat

Name         Location ProvisioningState
----         -------- -----------------
customScript eastus   Succeeded

Updates ekstensi tertentu yang diteruskan melalui alur. Di sini kita menggunakan ekstensi yang diteruskan melalui alur untuk memberikan perubahan yang ingin kita buat pada ekstensi. Lokasi ekstensi tidak diambil melalui alur melainkan melalui parameter yang ditentukan secara normal (oleh parameter splat).

Contoh 4: Menggunakan objek ekstensi sebagai lokasi dan parameter untuk memperbarui

$extToUpdate = Get-AzConnectedMachineExtension -ResourceGroupName connectedMachines -MachineName linux-eastus1_1 -Name customScript
# Update the settings on the object that will be used via the pipeline
$extToUpdate.Setting.commandToExecute = "ls -l"
$extToUpdate | Update-AzConnectedMachineExtension -ExtensionParameter $extToUpdate

Name         Location ProvisioningState
----         -------- -----------------
customScript eastus   Succeeded

Updates ekstensi tertentu yang diteruskan melalui alur. Di sini kami menggunakan ekstensi yang diteruskan melalui alur untuk membantu kami mengidentifikasi ekstensi mana yang ingin kami operasikan. Selain itu, kita menggunakan parameter objek ekstensi untuk menentukan apa yang harus diperbarui.

Parameter

-AsJob

Jalankan perintah sebagai pekerjaan

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AutoUpgradeMinorVersion

Menunjukkan apakah ekstensi harus menggunakan versi minor yang lebih baru jika tersedia pada waktu penyebaran. Setelah disebarkan, bagaimanapun, ekstensi tidak akan meningkatkan versi kecil kecuali dipekerjakan kembali, bahkan jika properti ini diatur ke true.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableAutomaticUpgrade

Menunjukkan apakah ekstensi harus ditingkatkan secara otomatis oleh platform jika ada versi yang lebih baru yang tersedia.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ExtensionParameter

Menjelaskan Pembaruan Ekstensi Mesin. Untuk membuat, lihat bagian CATATAN untuk properti EXTENSIONPARAMETER dan buat tabel hash.

Type:IMachineExtensionUpdate
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-ForceRerun

Bagaimana handler ekstensi harus dipaksa untuk memperbarui meskipun konfigurasi ekstensi tidak berubah.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

Parameter Identitas Untuk membangun, lihat bagian CATATAN untuk properti INPUTOBJECT dan membuat tabel hash.

Type:IConnectedMachineIdentity
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-MachineName

Nama komputer tempat ekstensi harus dibuat atau diperbarui.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Nama ekstensi komputer.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NoWait

Jalankan perintah secara asinkron

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProtectedSetting

Ekstensi dapat berisi protectedSettings atau protectedSettingsFromKeyVault atau tidak ada pengaturan yang dilindungi sama sekali.

Type:Hashtable
Aliases:ProtectedSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Publisher

Nama penerbit handler ekstensi.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ResourceGroupName

Nama grup sumber daya. Nama tidak peka huruf besar/kecil.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Setting

Pengaturan publik berformat Json untuk ekstensi.

Type:Hashtable
Aliases:Settings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SubscriptionId

ID langganan target.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Accept pipeline input:False
Accept wildcard characters:False
-Tag

Tag sumber daya

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Type

Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension".

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TypeHandlerVersion

Menentukan versi handler skrip.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Input

IMachineExtensionUpdate

IConnectedMachineIdentity

Output

IMachineExtension

Catatan

ALIAS

PROPERTI PARAMETER KOMPLEKS

Untuk membuat parameter yang dijelaskan di bawah ini, buat tabel hash yang berisi properti yang sesuai. Untuk informasi tentang tabel hash, jalankan Get-Help about_Hash_Tables.

EXTENSIONPARAMETER <IMachineExtensionUpdate>: Menjelaskan Pembaruan Ekstensi Mesin.

  • [Tag <IResourceUpdateTags>]: Tag sumber daya
    • [(Any) <String>]: Ini menunjukkan properti apa pun dapat ditambahkan ke objek ini.
  • [AutoUpgradeMinorVersion <Boolean?>]: Menunjukkan apakah ekstensi harus menggunakan versi minor yang lebih baru jika tersedia pada waktu penyebaran. Setelah disebarkan, bagaimanapun, ekstensi tidak akan meningkatkan versi kecil kecuali dipekerjakan kembali, bahkan jika properti ini diatur ke true.
  • [EnableAutomaticUpgrade <Boolean?>]: Menunjukkan apakah ekstensi harus ditingkatkan secara otomatis oleh platform jika ada versi yang lebih baru yang tersedia.
  • [ForceUpdateTag <String>]: Bagaimana handler ekstensi harus diperbarui meskipun konfigurasi ekstensi belum berubah.
  • [ProtectedSetting <IMachineExtensionUpdatePropertiesProtectedSettings>]: Ekstensi dapat berisi protectedSettings atau protectedSettingsFromKeyVault atau tidak ada pengaturan yang dilindungi sama sekali.
    • [(Any) <Object>]: Ini menunjukkan properti apa pun dapat ditambahkan ke objek ini.
  • [Publisher <String>]: Nama penerbit handler ekstensi.
  • [Setting <IMachineExtensionUpdatePropertiesSettings>]: Pengaturan publik berformat Json untuk ekstensi.
    • [(Any) <Object>]: Ini menunjukkan properti apa pun dapat ditambahkan ke objek ini.
  • [Type <String>]: Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension".
  • [TypeHandlerVersion <String>]: Menentukan versi handler skrip.

INPUTOBJECT <IConnectedMachineIdentity>: Parameter Identitas

  • [ExtensionName <String>]: Nama ekstensi komputer.
  • [GroupName <String>]: Nama sumber daya tautan privat.
  • [Id <String>]: Jalur identitas sumber daya
  • [Location <String>]: Lokasi sumber daya target.
  • [MachineName <String>]: Nama komputer hibrid.
  • [PrivateEndpointConnectionName <String>]: Nama koneksi titik akhir privat.
  • [PrivateLinkScopeId <String>]: Id (Guid) sumber daya Azure Arc PrivateLinkScope.
  • [ResourceGroupName <String>]: Nama grup sumber daya. Nama tidak peka huruf besar/kecil.
  • [ScopeName <String>]: Nama sumber daya Azure Arc PrivateLinkScope.
  • [SubscriptionId <String>]: ID langganan target.