Set-AzVMDscExtension
Konfigurálja a DSC-bővítményt egy virtuális gépen.
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
A Set-AzVMDscExtension parancsmag konfigurálja a Windows PowerShell Desired State Configuration (DSC) bővítményt egy erőforráscsoport virtuális gépén.
Példák
1. példa: DSC-bővítmény beállítása
Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM07" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -Version "1.10" -Location "West US"
Ez a parancs beállítja a VM07 nevű virtuális gép DSC-bővítményét, hogy Sample.ps1.zip töltse le az Stg nevű tárfiókból és az alapértelmezett tárolóból. A parancs meghívja a ConfigName nevű konfigurációt. A Sample.ps1.zip fájlt korábban a Publish-AzVMDscConfiguration használatával töltötték fel.
2. példa: DSC-bővítmény beállítása konfigurációs adatokkal
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"
Ez a parancs beállítja a VM13 nevű virtuális gép bővítményét, hogy Sample.ps1.zip töltse le az Stg nevű tárfiókból és a WindowsPowerShellDSC nevű tárolóból. A ConfigName nevű konfiguráció parancsa, amely megadja a konfigurációs adatokat és az argumentumokat. A Sample.ps1.zip fájlt korábban a Publish-AzVMDscConfiguration használatával töltötték fel.
3. példa: DSC-bővítmény beállítása automatikus frissítéssel rendelkező konfigurációs adatokkal
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
Ez a parancs beállítja a VM22 nevű virtuális gép bővítményét, hogy Sample.ps1.zip töltse le az Stg nevű tárfiókból és a WindowsPowerShellDSC nevű tárolóból. A parancs meghívja a ConfigName nevű konfigurációt, és megadja a konfigurációs adatokat és az argumentumokat. Ez a parancs lehetővé teszi a bővítménykezelő automatikus frissítését a legújabb verzióra. A Sample.ps1.zip korábban a Publish-AzVMDscConfiguration használatával töltötték fel.
Paraméterek
-ArchiveBlobName
Megadja a Publish-AzVMDscConfiguration parancsmag által korábban feltöltött konfigurációs fájl nevét.
Type: | String |
Aliases: | ConfigurationArchiveBlob |
Position: | 5 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveContainerName
Annak az Azure Storage-tárolónak a fajneve, ahol a konfigurációs archívum található.
Type: | String |
Aliases: | ContainerName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveResourceGroupName
Megadja annak az erőforráscsoportnak a nevét, amely a konfigurációs archívumot tartalmazó tárfiókot tartalmazza. Ez a paraméter nem kötelező, ha a tárfiók és a virtuális gép ugyanabban az erőforráscsoportban található.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveStorageAccountName
Az ArchiveBlobName letöltéséhez használt Azure Storage-fiók nevét adja meg.
Type: | String |
Aliases: | StorageAccountName |
Position: | 4 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveStorageEndpointSuffix
Megadja a tárolási végpont utótagját.
Type: | String |
Aliases: | StorageEndpointSuffix |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AutoUpdate
A Verzió paraméter által megadott bővítménykezelő verziót adja meg. Alapértelmezés szerint a bővítménykezelő nincs automatikusan feladva. Az Automatikus frissítés paraméter használatával engedélyezheti a bővítménykezelő automatikus frissítését a legújabb verzióra, amint és amikor elérhető.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigurationArgument
Egy kivonattáblát ad meg, amely a konfigurációs függvény argumentumait tartalmazza.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConfigurationData
Egy .psd1 fájl elérési útját adja meg, amely megadja a konfiguráció adatait.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConfigurationName
Megadja annak a konfigurációnak a nevét, amelyet a DSC-bővítmény meghív.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DataCollection
Az adatgyűjtés típusát adja meg. A paraméter elfogadható értékei a következők: Engedélyezés és letiltás.
Type: | String |
Accepted values: | Enable, Disable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Megadja az erőforrás-bővítmény elérési útját.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Megadja a bővítményt képviselő Azure Resource Manager-erőforrás nevét. Az alapértelmezett érték a Microsoft.Powershell.DSC.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoWait
Elindítja a műveletet, és azonnal visszatér, mielőtt a művelet befejeződik. Annak megállapításához, hogy a művelet sikeresen befejeződött-e, használjon más mechanizmust.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Megadja a virtuális gép erőforráscsoportjának nevét.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
Megadja annak a DSC-bővítménynek a verzióját, amelyre a Set-AzVMDscExtension alkalmazza a beállításokat.
Type: | String |
Aliases: | HandlerVersion |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMName
Annak a virtuális gépnek a nevét adja meg, amelyen telepítve van a DSC-bővítménykezelő.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WmfVersion
A WMF-verziót adja meg.
Type: | String |
Accepted values: | 4.0, 5.0, 5.1, latest |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |