Set-AzureRmVMDscExtension
Konfigurerar DSC-tillägget på en virtuell dator.
Varning
AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.
Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.
Syntax
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
Cmdleten Set-AzureRmVMDscExtension konfigurerar DSC-tillägget (Windows PowerShell Desired State Configuration) på en virtuell dator i en resursgrupp.
Exempel
Exempel 1: Ange ett DSC-tillägg
PS C:\> Set-AzureRmVMDscExtension -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-AzureRmVMDscConfiguration.
Exempel 2: Ange ett DSC-tillägg med konfigurationsdata
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"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-AzureRmVMDscConfiguration.
Exempel 3: Ange ett DSC-tillägg med konfigurationsdata som har automatisk uppdatering
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" -AutoUpdateDet 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. Sample.ps1.zip har tidigare laddats upp med hjälp av Publish-AzureRmVMDscConfiguration.
Parametrar
-ArchiveBlobName
Anger namnet på konfigurationsfilen som tidigare laddades upp av cmdleten Publish-AzureRmVMDscConfiguration.
| Typ: | String |
| Aliases: | ConfigurationArchiveBlob |
| Position: | 5 |
| standardvärde: | None |
| Obligatorisk: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ArchiveContainerName
Artnamn för Azure Storage-containern där konfigurationsarkivet finns.
| Typ: | String |
| Aliases: | ContainerName |
| Position: | Named |
| standardvärde: | None |
| Obligatorisk: | 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.
| Typ: | String |
| Position: | Named |
| standardvärde: | None |
| Obligatorisk: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ArchiveStorageAccountName
Anger det Azure Storage-kontonamn som används för att ladda ned ArchiveBlobName.
| Typ: | String |
| Aliases: | StorageAccountName |
| Position: | 4 |
| standardvärde: | None |
| Obligatorisk: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ArchiveStorageEndpointSuffix
Anger suffixet för lagringsslutpunkten.
| Typ: | String |
| Aliases: | StorageEndpointSuffix |
| Position: | Named |
| standardvärde: | None |
| Obligatorisk: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| standardvärde: | None |
| Obligatorisk: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConfigurationArgument
Anger en hash-tabell som innehåller argumenten till konfigurationsfunktionen.
| Typ: | Hashtable |
| Position: | Named |
| standardvärde: | None |
| Obligatorisk: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ConfigurationName
Anger namnet på konfigurationen som DSC-tillägget anropar.
| Typ: | String |
| Position: | Named |
| standardvärde: | None |
| Obligatorisk: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
| Typ: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| standardvärde: | False |
| Obligatorisk: | 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.
| Typ: | String |
| accepterade värden: | Enable, Disable |
| Position: | Named |
| standardvärde: | None |
| Obligatorisk: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
| Typ: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| standardvärde: | None |
| Obligatorisk: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Tvingar kommandot att köras utan att be om användarbekräftelse.
| Typ: | SwitchParameter |
| Position: | Named |
| standardvärde: | None |
| Obligatorisk: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
Anger sökvägen till resurstillägget.
| Typ: | String |
| Position: | Named |
| standardvärde: | None |
| Obligatorisk: | 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.
| Typ: | String |
| Position: | Named |
| standardvärde: | None |
| Obligatorisk: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
Anger namnet på resursgruppen för den virtuella datorn.
| Typ: | String |
| Position: | 2 |
| standardvärde: | None |
| Obligatorisk: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Version
Anger vilken version av DSC-tillägget som Set-AzureRmVMDscExtension tillämpar inställningarna på.
| Typ: | String |
| Aliases: | HandlerVersion |
| Position: | 1 |
| standardvärde: | None |
| Obligatorisk: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMName
Anger namnet på den virtuella dator där DSC-tilläggshanteraren är installerad.
| Typ: | String |
| Position: | 3 |
| standardvärde: | None |
| Obligatorisk: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
| Typ: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| standardvärde: | False |
| Obligatorisk: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WmfVersion
Anger WMF-versionen.
| Typ: | String |
| accepterade värden: | 4.0, 5.0, 5.1, latest |
| Position: | Named |
| standardvärde: | None |
| Obligatorisk: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |