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.

Type:String
Aliases:ConfigurationArchiveBlob
Position:5
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ArchiveContainerName

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

Type:String
Aliases:ContainerName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ArchiveStorageAccountName

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

Type:String
Aliases:StorageAccountName
Position:4
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ArchiveStorageEndpointSuffix

Anger suffixet för lagringsslutpunkten.

Type:String
Aliases:StorageEndpointSuffix
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConfigurationArgument

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

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationData

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DataCollection

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

Type:String
Accepted values:Enable, Disable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Anger sökvägen till resurstillägget.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Version

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

Type:String
Aliases:HandlerVersion
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMName

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

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WmfVersion

Anger WMF-versionen.

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

Indata

String

Hashtable

Utdata

PSAzureOperationResponse