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 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

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. Dříve nahrál soubor Sample.ps1.zip 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, 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. Dříve nahrál soubor Sample.ps1.zip 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, 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 nahráli Sample.ps1.zip pomocí publish-AzVMDscConfiguration.

Parametry

-ArchiveBlobName

Určuje název konfiguračního souboru, který byl dříve odeslán rutinou 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 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: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 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