Aracılığıyla paylaş

Set-AzVMDscExtension

  • Başvuru
Modül:
Az.Compute

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

Syntax

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
Aliases:ConfigurationArchiveBlob
Position:5
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-ArchiveContainerName

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

Tür:String
Aliases:ContainerName
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters: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
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-ArchiveStorageAccountName

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

Tür:String
Aliases:StorageAccountName
Position:4
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-ArchiveStorageEndpointSuffix

Depolama uç noktası sonekini belirtir.

Tür:String
Aliases:StorageEndpointSuffix
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters: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
varsayılan değer:None
Gerekli:False
Accept pipeline input:False
Accept wildcard characters:False

-ConfigurationArgument

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

Tür:Hashtable
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationData

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

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationName

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

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Tür:SwitchParameter
Aliases:cf
Position:Named
varsayılan değer:False
Gerekli:False
Accept pipeline input:False
Accept wildcard characters: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
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Tür:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Tür:SwitchParameter
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Kaynak uzantısının yolunu belirtir.

Tür:String
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters: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
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters: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
varsayılan değer:None
Gerekli:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Sanal makinenin kaynak grubunun adını belirtir.

Tür:String
Position:2
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-Version

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

Tür:String
Aliases:HandlerVersion
Position:1
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-VMName

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

Tür:String
Position:3
varsayılan değer:None
Gerekli:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Tür:SwitchParameter
Aliases:wi
Position:Named
varsayılan değer:False
Gerekli:False
Accept pipeline input:False
Accept wildcard characters:False

-WmfVersion

WMF sürümünü belirtir.

Tür:String
kabul edilen değerler:4.0, 5.0, 5.1, latest
Position:Named
varsayılan değer:None
Gerekli:False
Accept pipeline input:True
Accept wildcard characters:False

Girişler

String

Hashtable

Çıkışlar

PSAzureOperationResponse