Aracılığıyla paylaş

Set-AzVMDscExtension

  • Başvuru
Modül:
Az.Compute

Bir sanal makinede DSC uzantısını yapılandırılır.

Sözdizimi

Set-AzVMDscExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-ArchiveBlobName] <String>
   [-ArchiveStorageAccountName] <String>
   [-ArchiveResourceGroupName <String>]
   [-ArchiveStorageEndpointSuffix <String>]
   [-ArchiveContainerName <String>]
   [-ConfigurationName <String>]
   [-ConfigurationArgument <Hashtable>]
   [-ConfigurationData <String>]
   [-Version] <String>
   [-Force]
   [-Location <String>]
   [-AutoUpdate]
   [-WmfVersion <String>]
   [-DataCollection <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzVMDscExtension cmdlet'i, kaynak grubundaki bir sanal makinede Windows PowerShell İstenen Durum Yapılandırması (DSC) uzantısını yapılandırıyor.

Örnekler

Örnek 1: DSC uzantısı ayarlama

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM07" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -Version "1.10" -Location "West US"

Bu komut, VM07 adlı sanal makinedeki DSC uzantısını Stg adlı depolama hesabından ve varsayılan kapsayıcıdan Sample.ps1.zip indirecek şekilde ayarlar. komutu ConfigName adlı yapılandırmayı çağırır. Sample.ps1.zip dosyası daha önce Publish-AzVMDscConfiguration kullanılarak karşıya yüklenmişti.

Örnek 2: Yapılandırma verileriyle DSC uzantısı ayarlama

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM13" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName "WindowsPowerShellDSC" -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US"

Bu komut, VM13 adlı sanal makinedeki uzantıyı Stg adlı depolama hesabından ve WindowsPowerShellDSC adlı kapsayıcıdan Sample.ps1.zip indirecek şekilde ayarlar. Yapılandırmanın ConfigName adlı komutu ve yapılandırma verilerini ve bağımsız değişkenlerini belirtir. Sample.ps1.zip dosyası daha önce Publish-AzVMDscConfiguration kullanılarak karşıya yüklenmişti.

Örnek 3: Otomatik güncelleştirme içeren yapılandırma verileriyle bir DSC uzantısı ayarlama

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM22" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName WindowsPowerShellDSC -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US" -AutoUpdate

Bu komut, VM22 adlı sanal makinedeki uzantıyı Stg adlı depolama hesabından ve WindowsPowerShellDSC adlı kapsayıcıdan Sample.ps1.zip indirecek şekilde ayarlar. komutu ConfigName adlı yapılandırmayı çağırır ve yapılandırma verilerini ve bağımsız değişkenlerini belirtir. Bu komut ayrıca uzantı işleyicisinin en son sürüme otomatik olarak güncelleştirilmeye olanak tanır. Sample.ps1.zip daha önce Publish-AzVMDscConfiguration kullanılarak karşıya yüklenmişti.

Parametreler

-ArchiveBlobName

Daha önce Publish-AzVMDscConfiguration cmdlet'i tarafından karşıya yüklenen yapılandırma dosyasının adını belirtir.

Tür:String
Diğer adlar:ConfigurationArchiveBlob
Position:5
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ArchiveContainerName

Yapılandırma arşivinin bulunduğu Azure depolama kapsayıcısının tür adı.

Tür:String
Diğer adlar:ContainerName
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ArchiveResourceGroupName

Yapılandırma arşivini içeren depolama hesabını içeren kaynak grubunun adını belirtir. Depolama hesabı ve sanal makine aynı kaynak grubundaysa bu parametre isteğe bağlıdır.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ArchiveStorageAccountName

ArchiveBlobName dosyasını indirmek için kullanılan Azure depolama hesabı adını belirtir.

Tür:String
Diğer adlar:StorageAccountName
Position:4
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ArchiveStorageEndpointSuffix

Depolama uç noktası sonekini belirtir.

Tür:String
Diğer adlar:StorageEndpointSuffix
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-AutoUpdate

Version parametresi tarafından belirtilen uzantı işleyici sürümünü belirtir. Varsayılan olarak uzantı işleyicisi otomatik olarak güncelleştirilmemiştir. Uzantı işleyicisinin en son sürüme ve kullanılabilir olduğunda otomatik güncelleştirmesini etkinleştirmek için AutoUpdate parametresini kullanın.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ConfigurationArgument

Yapılandırma işlevinin bağımsız değişkenlerini içeren bir karma tablo belirtir.

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ConfigurationData

Yapılandırma verilerini belirten bir .psd1 dosyasının yolunu belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ConfigurationName

DSC Uzantısının çağırdığını yapılandırmanın adını belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DataCollection

Veri toplama türünü belirtir. Bu parametre için kabul edilebilir değerler şunlardır: Etkinleştir ve Devre Dışı Bırak.

Tür:String
Kabul edilen değerler:Enable, Disable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Force

Komutu, kullanıcı onayı istemeden çalışmaya zorlar.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Location

Kaynak uzantısının yolunu belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Name

Uzantıyı temsil eden Azure Resource Manager kaynağının adını belirtir. Varsayılan değer Microsoft.Powershell.DSC'dir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-NoWait

İşlemi başlatır ve işlem tamamlanmadan hemen önce döndürür. İşlemin başarıyla tamamlandığını belirlemek için başka bir mekanizma kullanın.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ResourceGroupName

Sanal makinenin kaynak grubunun adını belirtir.

Tür:String
Position:2
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Version

Set-AzVMDscExtension uygulamasının ayarları uyguladığı DSC uzantısının sürümünü belirtir.

Tür:String
Diğer adlar:HandlerVersion
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-VMName

DSC uzantısı işleyicisinin yüklü olduğu sanal makinenin adını belirtir.

Tür:String
Position:3
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WmfVersion

WMF sürümünü belirtir.

Tür:String
Kabul edilen değerler:4.0, 5.0, 5.1, latest
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

Girişler

String

Hashtable

Çıkışlar

PSAzureOperationResponse