Sdílet prostřednictvím

Set-AzVMDscExtension

  • Reference
Modul:
Az.Compute

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

Syntaxe

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

Rutina Set-AzVMDscExtension nakonfiguruje 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

Set-AzVMDscExtension -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 odeslán pomocí Publish-AzVMDscConfiguration.

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

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"

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

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

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

Tento příkaz nastaví rozšíření na virtuálním počítači S názvem VM22 pro stažení Sample.ps1.zip z účtu úložiště s názvem Stg a kontejneru 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-AzVMDscConfiguration.

Parametry

-ArchiveBlobName

Určuje název konfiguračního souboru, který dříve nahrál rutina Publish-AzVMDscConfiguration.

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 vás vyzve 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:AzContext, 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

-NoWait

Spustí operaci a vrátí se okamžitě před dokončením operace. Pokud chcete zjistit, jestli se operace úspěšně dokončila, použijte jiný mechanismus.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
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-AzVMDscExtension 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

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

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