Dela via

Set-AzVMDscExtension

  • Referens
Modul:
Az.Compute

Konfigurerar DSC-tillägget på en virtuell dator.

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

Cmdleten Set-AzVMDscExtension konfigurerar DSC-tillägget (Windows PowerShell Desired State Configuration) på en virtuell dator i en resursgrupp.

Exempel

Exempel 1: Ange ett DSC-tillägg

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM07" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -Version "1.10" -Location "West US"

Det här kommandot anger DSC-tillägget på den virtuella datorn med namnet VM07 för att ladda ned Sample.ps1.zip från lagringskontot med namnet Stg och standardcontainern. Kommandot anropar konfigurationen med namnet ConfigName. Den Sample.ps1.zip filen laddades upp tidigare med hjälp av Publish-AzVMDscConfiguration.

Exempel 2: Ange ett DSC-tillägg med konfigurationsdata

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"

Det här kommandot anger tillägget på den virtuella datorn med namnet VM13 för att ladda ned Sample.ps1.zip från lagringskontot med namnet Stg och containern med namnet WindowsPowerShellDSC. Kommandot konfigurationen med namnet ConfigName och anger konfigurationsdata och argument. Den Sample.ps1.zip filen laddades upp tidigare med hjälp av Publish-AzVMDscConfiguration.

Exempel 3: Ange ett DSC-tillägg med konfigurationsdata som har automatisk uppdatering

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

Det här kommandot anger tillägget på den virtuella datorn med namnet VM22 för att ladda ned Sample.ps1.zip från lagringskontot med namnet Stg och containern med namnet WindowsPowerShellDSC. Kommandot anropar konfigurationen med namnet ConfigName och anger konfigurationsdata och argument. Det här kommandot aktiverar även automatisk uppdatering av tilläggshanteraren till den senaste versionen. Den Sample.ps1.zip laddades upp tidigare med hjälp av Publish-AzVMDscConfiguration.

Parametrar

-ArchiveBlobName

Anger namnet på konfigurationsfilen som tidigare laddades upp av cmdleten Publish-AzVMDscConfiguration.

Typ:String
Alias:ConfigurationArchiveBlob
Position:5
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ArchiveContainerName

Artnamn för Azure Storage-containern där konfigurationsarkivet finns.

Typ:String
Alias:ContainerName
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ArchiveResourceGroupName

Anger namnet på resursgruppen som innehåller lagringskontot som innehåller konfigurationsarkivet. Den här parametern är valfri om både lagringskontot och den virtuella datorn finns i samma resursgrupp.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ArchiveStorageAccountName

Anger det Azure Storage-kontonamn som används för att ladda ned ArchiveBlobName.

Typ:String
Alias:StorageAccountName
Position:4
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ArchiveStorageEndpointSuffix

Anger suffixet för lagringsslutpunkten.

Typ:String
Alias:StorageEndpointSuffix
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AutoUpdate

Anger den tilläggshanterarversion som anges av parametern Version . Som standard är tilläggshanteraren inte automatiskt uppdaterad. Använd parametern AutoUpdate för att aktivera automatisk uppdatering av tilläggshanteraren till den senaste versionen om och när den är tillgänglig.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ConfigurationArgument

Anger en hash-tabell som innehåller argumenten till konfigurationsfunktionen.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ConfigurationData

Anger sökvägen till en .psd1-fil som anger data för konfigurationen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ConfigurationName

Anger namnet på konfigurationen som DSC-tillägget anropar.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DataCollection

Anger datainsamlingstypen. De godtagbara värdena för den här parametern är: Aktivera och inaktivera.

Typ:String
Godkända värden:Enable, Disable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Location

Anger sökvägen till resurstillägget.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger namnet på den Azure Resource Manager-resurs som representerar tillägget. Standardvärdet är Microsoft.Powershell.DSC.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NoWait

Startar åtgärden och returnerar omedelbart innan åtgärden har slutförts. Använd någon annan mekanism för att avgöra om åtgärden har slutförts.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

Anger namnet på resursgruppen för den virtuella datorn.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Version

Anger vilken version av DSC-tillägget som Set-AzVMDscExtension tillämpar inställningarna på.

Typ:String
Alias:HandlerVersion
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VMName

Anger namnet på den virtuella dator där DSC-tilläggshanteraren är installerad.

Typ:String
Position:3
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WmfVersion

Anger WMF-versionen.

Typ:String
Godkända värden:4.0, 5.0, 5.1, latest
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

String

Hashtable

Utdata

PSAzureOperationResponse