Sdílet prostřednictvím

Set-AzureRmVMDscExtension

  • Reference
Modul:
AzureRM.Compute

Nakonfiguruje rozšíření DSC na virtuálním počítači.

Upozorňující

Modul AzureRM PowerShell je od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntaxe

Set-AzureRmVMDscExtension
   [-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>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina Set-AzureRmVMDscExtension konfiguruje rozšíření DSC (Windows PowerShell Desired State Configuration) na virtuálním počítači ve skupině prostředků.

Příklady

Příklad 1: Nastavení rozšíření DSC

PS C:\> Set-AzureRmVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM07" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -Version "1.10" -Location "West US"

Tento příkaz nastaví rozšíření DSC na virtuálním počítači s názvem VM07 tak, aby stahoval Sample.ps1.zip z účtu úložiště s názvem Stg a výchozí kontejner. Příkaz vyvolá konfiguraci s názvem ConfigName. Soubor Sample.ps1.zip byl dříve nahrán pomocí Publish-AzureRmVMDscConfiguration.

Příklad 2: Nastavení rozšíření DSC s konfiguračními daty

PS C:\> Set-AzureRmVMDscExtension -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"

Tento příkaz nastaví rozšíření na virtuálním počítači S názvem VM13, aby se z účtu úložiště s názvem Stg a kontejner s názvem WindowsPowerShellDSC stáhl Sample.ps1.zip. Příkaz konfigurace s názvem ConfigName a určuje konfigurační data a argumenty. Soubor Sample.ps1.zip byl dříve nahrán pomocí Publish-AzureRmVMDscConfiguration.

Příklad 3: Nastavení rozšíření DSC s konfiguračními daty, která mají automatickou aktualizaci

PS C:\> Set-AzureRmVMDscExtension -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

Tento příkaz nastaví rozšíření na virtuálním počítači S názvem VM22, aby se stáhl Sample.ps1.zip z účtu úložiště s názvem Stg a kontejner s názvem WindowsPowerShellDSC. Příkaz vyvolá konfiguraci s názvem ConfigName a určuje konfigurační data a argumenty. Tento příkaz také umožňuje automatickou aktualizaci obslužné rutiny rozšíření na nejnovější verzi. Dříve se Sample.ps1.zip nahrál pomocí Publish-AzureRmVMDscConfiguration.

Parametry

-ArchiveBlobName

Určuje název konfiguračního souboru, který byl dříve odeslán rutinou Publish-AzureRmVMDscConfiguration.

Typ:String
Aliasy:ConfigurationArchiveBlob
Position:5
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ArchiveContainerName

Druh názvu kontejneru úložiště Azure, kde se nachází archiv konfigurace.

Typ:String
Aliasy:ContainerName
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ArchiveResourceGroupName

Určuje název skupiny prostředků, která obsahuje účet úložiště, který obsahuje archiv konfigurace. Tento parametr je volitelný, pokud je účet úložiště i virtuální počítač ve stejné skupině prostředků.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ArchiveStorageAccountName

Určuje název účtu úložiště Azure, který se používá ke stažení ArchiveBlobName.

Typ:String
Aliasy:StorageAccountName
Position:4
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ArchiveStorageEndpointSuffix

Určuje příponu koncového bodu úložiště.

Typ:String
Aliasy:StorageEndpointSuffix
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-AutoUpdate

Určuje verzi obslužné rutiny rozšíření určenou parametrem Version . Ve výchozím nastavení není obslužná rutina rozšíření automaticky aktualizována. Pomocí parametru AutoUpdate povolte automatickou aktualizaci obslužné rutiny rozšíření na nejnovější verzi jako a kdy je k dispozici.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ConfigurationArgument

Určuje tabulku hash, která obsahuje argumenty konfigurační funkce.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ConfigurationData

Určuje cestu k souboru .psd1, který určuje data pro konfiguraci.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ConfigurationName

Určuje název konfigurace, kterou rozšíření DSC vyvolá.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DataCollection

Určuje typ shromažďování dat. Přijatelné hodnoty pro tento parametr jsou: Enable a Disable.

Typ:String
Přípustné hodnoty:Enable, Disable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Location

Určuje cestu rozšíření prostředků.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název prostředku Azure Resource Manageru, který představuje rozšíření. Výchozí hodnota je Microsoft.Powershell.DSC.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků virtuálního počítače.

Typ:String
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Version

Určuje verzi rozšíření DSC, na kterou set-AzureRmVMDscExtension použije nastavení.

Typ:String
Aliasy:HandlerVersion
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VMName

Určuje název virtuálního počítače, na kterém je nainstalovaná obslužná rutina rozšíření DSC.

Typ:String
Position:3
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WmfVersion

Určuje verzi WMF.

Typ:String
Přípustné hodnoty:4.0, 5.0, 5.1, latest
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

String

Hashtable

Výstupy

PSAzureOperationResponse