Set-AzVMDscExtension

  • Referencia
Modul:
Az.Compute

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

Bevitelek

String

Hashtable

Kimenetek

PSAzureOperationResponse