Set-AzVMDscExtension
Bir sanal makinede DSC uzantısını yapılandırılır.
Syntax
Default (Varsayılan)
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 Desired State Configuration (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.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: ConfigurationArchiveBlob
Parametre kümeleri
(All)
Position: 5 Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-ArchiveContainerName
Yapılandırma arşivinin bulunduğu Azure depolama kapsayıcısının tür adı.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: KonteynerAdı
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-ArchiveStorageAccountName
ArchiveBlobName dosyasını indirmek için kullanılan Azure depolama hesabı adını belirtir.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: DepolamaHesapAdı
Parametre kümeleri
(All)
Position: 4 Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-ArchiveStorageEndpointSuffix
Depolama uç noktası sonekini belirtir.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: StorageEndpointSuffix
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Tür: SwitchParameter
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-ConfigurationArgument
Yapılandırma işlevinin bağımsız değişkenlerini içeren bir karma tablo belirtir.
Parametre özellikleri
Tür: Hashtable
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-ConfigurationData
Yapılandırma verilerini belirten bir .psd1 dosyasının yolunu belirtir.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-ConfigurationName
DSC Uzantısının çağırdığını yapılandırmanın adını belirtir.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
Tür: SwitchParameter
Default value: False Joker karakterleri destekler: False DontShow: False Diğer adlar: Cf
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Tür: String
Default value: None Kabul edilen değerler: Enable, Disable Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
Parametre özellikleri
Tür: IAzureContextContainer
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: AzContext, AzureRmContext, AzureCredential
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-Force
Komutu, kullanıcı onayı istemeden çalışmaya zorlar.
Parametre özellikleri
Tür: SwitchParameter
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-Location
Kaynak uzantısının yolunu belirtir.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-Name
Uzantıyı temsil eden Azure Resource Manager kaynağının adını belirtir.
Varsayılan değer Microsoft. Powershell.DSC.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Tür: SwitchParameter
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-ResourceGroupName
Sanal makinenin kaynak grubunun adını belirtir.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: 2 Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-Version
Ayarların uygulandığı DSC uzantısının Set-AzVMDscExtension sürümünü belirtir.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: HandlerVersion
Parametre kümeleri
(All)
Position: 1 Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-VMName
DSC uzantısı işleyicisinin yüklü olduğu sanal makinenin adını belirtir.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: 3 Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir.
Cmdlet çalıştırılmaz.
Parametre özellikleri
Tür: SwitchParameter
Default value: False Joker karakterleri destekler: False DontShow: False Diğer adlar: Wi
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-WmfVersion
WMF sürümünü belirtir.
Parametre özellikleri
Tür: String
Default value: None Kabul edilen değerler: 4.0, 5.0, 5.1, latest Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: True Kalan bağımsız değişkenlerden elde edilen değer: False
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters .
Çıkışlar
