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