Saran dan Komentar

New-AzConnectedMachineExtension

  • Referensi
Modul:
Az.ConnectedMachine

Operasi untuk membuat atau memperbarui ekstensi.

Sintaks

New-AzConnectedMachineExtension
   -MachineName <String>
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-SubscriptionId <String>]
   [-AutoUpgradeMinorVersion]
   [-EnableAutomaticUpgrade]
   [-ExtensionType <String>]
   [-ForceRerun <String>]
   [-InstanceViewName <String>]
   [-InstanceViewType <String>]
   [-InstanceViewTypeHandlerVersion <String>]
   [-ProtectedSetting <Hashtable>]
   [-Publisher <String>]
   [-Setting <Hashtable>]
   [-StatusCode <String>]
   [-StatusDisplayStatus <String>]
   [-StatusLevel <StatusLevelTypes>]
   [-StatusMessage <String>]
   [-StatusTime <DateTime>]
   [-Tag <Hashtable>]
   [-TypeHandlerVersion <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]
New-AzConnectedMachineExtension
   -MachineName <String>
   -Name <String>
   -ResourceGroupName <String>
   -ExtensionParameter <IMachineExtension>
   [-SubscriptionId <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]
New-AzConnectedMachineExtension
   -InputObject <IConnectedMachineIdentity>
   -ExtensionParameter <IMachineExtension>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]
New-AzConnectedMachineExtension
   -InputObject <IConnectedMachineIdentity>
   -Location <String>
   [-AutoUpgradeMinorVersion]
   [-EnableAutomaticUpgrade]
   [-ExtensionType <String>]
   [-ForceRerun <String>]
   [-InstanceViewName <String>]
   [-InstanceViewType <String>]
   [-InstanceViewTypeHandlerVersion <String>]
   [-ProtectedSetting <Hashtable>]
   [-Publisher <String>]
   [-Setting <Hashtable>]
   [-StatusCode <String>]
   [-StatusDisplayStatus <String>]
   [-StatusLevel <StatusLevelTypes>]
   [-StatusMessage <String>]
   [-StatusTime <DateTime>]
   [-Tag <Hashtable>]
   [-TypeHandlerVersion <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Deskripsi

Operasi untuk membuat atau memperbarui ekstensi.

Contoh

Contoh 1: Menambahkan ekstensi baru ke komputer

$Settings = @{ "commandToExecute" = "powershell.exe -c Get-Process" }
New-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName win-eastus1 -Location eastus -Publisher "Microsoft.Compute" -TypeHandlerVersion 1.10 -Settings $Settings -ExtensionType CustomScriptExtension

Name   Location ProvisioningState
----   -------- -----------------
custom eastus   Succeeded

Mengatur ekstensi pada komputer.

Contoh 2: Menambahkan ekstensi baru dengan parameter ekstensi yang ditentukan melalui alur

$otherExtension = Get-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName other
$otherExtension | New-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName important

Name   Location ProvisioningState
----   -------- -----------------
custom eastus   Succeeded

Ini membuat ekstensi baru dengan parameter ekstensi yang disediakan oleh objek yang diteruskan melalui alur. Ini bagus jika Anda ingin mengambil parameter satu komputer dan menerapkannya ke komputer lain.

Contoh 3: Menambahkan ekstensi baru dengan lokasi yang ditentukan melalui alur

$identity = [Microsoft.Azure.PowerShell.Cmdlets.ConnectedMachine.Models.ConnectedMachineIdentity]@{
    Id = "/subscriptions/$($SubscriptionId)/resourceGroups/$($ResourceGroupName)/providers/Microsoft.HybridCompute/machines/$MachineName/extensions/$ExtensionName"
}
$Settings = @{ "commandToExecute" = "powershell.exe -c Get-Process" }
$identity | New-AzConnectedMachineExtension -Location eastus -Publisher "Microsoft.Compute" -TypeHandlerVersion 1.10 -Settings $Settings -ExtensionType CustomScriptExtension

Name   Location ProvisioningState
----   -------- -----------------
custom eastus   Succeeded

Ini membuat ekstensi komputer baru menggunakan identitas yang disediakan melalui alur. Anda mungkin tidak akan melakukan ini, tetapi itu mungkin.

Contoh 4: Menambahkan ekstensi baru menggunakan objek ekstensi sebagai lokasi dan parameter untuk memperbarui

$ext = Get-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName other
$ext | New-AzConnectedMachineExtension -ExtensionParameter $ext

Ini membuat ekstensi komputer baru menggunakan identitas yang disediakan melalui alur dan detail ekstensi yang disediakan oleh objek ekstensi yang diteruskan. Anda mungkin tidak akan melakukan ini, tetapi itu mungkin.

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 Ekstensi Mesin. Untuk membuat, lihat bagian CATATAN untuk properti EXTENSIONPARAMETER dan membuat tabel hash.

Type:IMachineExtension
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-ExtensionType

Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension".

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

Bagaimana handler ekstensi harus diperbarui 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 buat tabel hash.

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

Nama ekstensi komputer.

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

Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension".

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

Menentukan versi handler skrip.

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

Lokasi geografis tempat sumber daya berada

Type:String
Position:Named
Default value:None
Accept pipeline input:False
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
-StatusCode

Kode status.

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

Label pendek yang dapat dilokalkan untuk status tersebut.

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

Kode tingkat.

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

Pesan status terperinci, termasuk untuk pemberitahuan dan pesan kesalahan.

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

Waktu status.

Type:DateTime
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
-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

IMachineExtension

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 <IMachineExtension>: Menjelaskan Ekstensi Mesin.

  • Location <String>: Lokasi geografis tempat sumber daya berada
  • [Tag <ITrackedResourceTags>]: 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 dipaksa untuk memperbarui meskipun konfigurasi ekstensi tidak berubah.
  • [InstanceViewName <String>]: Nama ekstensi komputer.
  • [InstanceViewType <String>]: Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension".
  • [InstanceViewTypeHandlerVersion <String>]: Menentukan versi penangan skrip.
  • [MachineExtensionType <String>]: Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension".
  • [ProtectedSetting <IMachineExtensionPropertiesProtectedSettings>]: 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 <IMachineExtensionPropertiesSettings>]: Pengaturan publik berformat Json untuk ekstensi.
    • [(Any) <Object>]: Ini menunjukkan properti apa pun dapat ditambahkan ke objek ini.
  • [StatusCode <String>]: Kode status.
  • [StatusDisplayStatus <String>]: Label pendek yang dapat dilokalkan untuk status.
  • [StatusLevel <StatusLevelTypes?>]: Kode tingkat.
  • [StatusMessage <String>]: Pesan status terperinci, termasuk untuk pemberitahuan dan pesan kesalahan.
  • [StatusTime <DateTime?>]: Waktu status.
  • [SystemDataCreatedAt <DateTime?>]: Tanda waktu pembuatan sumber daya (UTC).
  • [SystemDataCreatedBy <String>]: Identitas yang membuat sumber daya.
  • [SystemDataCreatedByType <CreatedByType?>]: Jenis identitas yang membuat sumber daya.
  • [SystemDataLastModifiedAt <DateTime?>]: Tanda waktu modifikasi terakhir sumber daya (UTC)
  • [SystemDataLastModifiedBy <String>]: Identitas yang terakhir mengubah sumber daya.
  • [SystemDataLastModifiedByType <CreatedByType?>]: Jenis identitas yang terakhir memodifikasi sumber daya.
  • [TypeHandlerVersion <String>]: Menentukan versi penangan 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.