Set-AzVMDscExtension

  • Odwołanie
Moduł:
Az.Compute

Konfiguruje rozszerzenie DSC na maszynie wirtualnej.

Składnia

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

Opis

Polecenie cmdlet Set-AzVMDscExtension konfiguruje rozszerzenie Windows PowerShell Desired State Configuration (DSC) na maszynie wirtualnej w grupie zasobów.

Przykłady

Przykład 1. Ustawianie rozszerzenia DSC

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

To polecenie ustawia rozszerzenie DSC na maszynie wirtualnej o nazwie VM07 w celu pobrania Sample.ps1.zip z konta magazynu o nazwie Stg i kontenera domyślnego. Polecenie wywołuje konfigurację o nazwie ConfigName. Plik Sample.ps1.zip został wcześniej przekazany przy użyciu polecenia Publish-AzVMDscConfiguration.

Przykład 2. Ustawianie rozszerzenia DSC z danymi konfiguracji

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"

To polecenie ustawia rozszerzenie na maszynie wirtualnej o nazwie VM13, aby pobrać Sample.ps1.zip z konta magazynu o nazwie Stg i kontenera o nazwie WindowsPowerShellDSC. Polecenie konfiguracji o nazwie ConfigName i określa dane konfiguracji i argumenty. Plik Sample.ps1.zip został wcześniej przekazany przy użyciu polecenia Publish-AzVMDscConfiguration.

Przykład 3. Ustawianie rozszerzenia DSC z danymi konfiguracji, które mają automatyczną aktualizację

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

To polecenie ustawia rozszerzenie na maszynie wirtualnej o nazwie VM22, aby pobrać Sample.ps1.zip z konta magazynu o nazwie Stg i kontenera o nazwie WindowsPowerShellDSC. Polecenie wywołuje konfigurację o nazwie ConfigName i określa dane konfiguracji i argumenty. To polecenie umożliwia również automatyczną aktualizację programu obsługi rozszerzeń do najnowszej wersji. Sample.ps1.zip został wcześniej przekazany przy użyciu polecenia Publish-AzVMDscConfiguration.

Parametry

-ArchiveBlobName

Określa nazwę pliku konfiguracji, który został wcześniej przekazany przez polecenie cmdlet Publish-AzVMDscConfiguration.

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

-ArchiveContainerName

Nazwa gatunku kontenera usługi Azure Storage, w którym znajduje się archiwum konfiguracji.

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

-ArchiveResourceGroupName

Określa nazwę grupy zasobów, która zawiera konto magazynu zawierające archiwum konfiguracji. Ten parametr jest opcjonalny, jeśli konto magazynu i maszyna wirtualna znajdują się w tej samej grupie zasobów.

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

-ArchiveStorageAccountName

Określa nazwę konta magazynu platformy Azure używaną do pobierania parametru ArchiveBlobName.

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

-ArchiveStorageEndpointSuffix

Określa sufiks punktu końcowego magazynu.

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

-AutoUpdate

Określa wersję programu obsługi rozszerzeń określoną przez parametr Version . Domyślnie program obsługi rozszerzeń nie jest automatycznie zaktualizowany. Użyj parametru AutoUpdate , aby włączyć automatyczną aktualizację programu obsługi rozszerzeń do najnowszej wersji jako i, gdy jest dostępna.

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

-ConfigurationArgument

Określa tabelę skrótów zawierającą argumenty funkcji konfiguracji.

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

-ConfigurationData

Określa ścieżkę pliku psd1, który określa dane konfiguracji.

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

-ConfigurationName

Określa nazwę konfiguracji, którą wywołuje rozszerzenie DSC.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-DataCollection

Określa typ zbierania danych. Dopuszczalne wartości tego parametru to: Włącz i Wyłącz.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

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

-Location

Określa ścieżkę rozszerzenia zasobu.

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

-Name

Określa nazwę zasobu usługi Azure Resource Manager, który reprezentuje rozszerzenie. Wartość domyślna to Microsoft.Powershell.DSC.

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

-NoWait

Uruchamia operację i zwraca natychmiast, zanim operacja zostanie ukończona. Aby określić, czy operacja została ukończona pomyślnie, użyj innego mechanizmu.

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

-ResourceGroupName

Określa nazwę grupy zasobów maszyny wirtualnej.

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

-Version

Określa wersję rozszerzenia DSC, do którego są stosowane ustawienia Set-AzVMDscExtension.

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

-VMName

Określa nazwę maszyny wirtualnej, na której zainstalowano program obsługi rozszerzenia DSC.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

-WmfVersion

Określa wersję programu WMF.

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

Dane wejściowe

String

Hashtable

Dane wyjściowe

PSAzureOperationResponse