Publish-AzVMDscConfiguration

  • Odwołanie
Moduł:
Az.Compute

Przekazuje skrypt DSC do usługi Azure Blob Storage.

Składnia

Publish-AzVMDscConfiguration
       [-ResourceGroupName] <String>
       [-ConfigurationPath] <String>
       [[-ContainerName] <String>]
       [-StorageAccountName] <String>
       [-StorageEndpointSuffix <String>]
       [-Force]
       [-SkipDependencyDetection]
       [-ConfigurationDataPath <String>]
       [-AdditionalPath <String[]>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-AzVMDscConfiguration
       [-ConfigurationPath] <String>
       [[-OutputArchivePath] <String>]
       [-Force]
       [-SkipDependencyDetection]
       [-ConfigurationDataPath <String>]
       [-AdditionalPath <String[]>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Opis

Polecenie cmdlet Publish-AzVMDscConfiguration przekazuje skrypt Desired State Configuration (DSC) do usługi Azure Blob Storage, który później można zastosować do maszyn wirtualnych platformy Azure przy użyciu polecenia cmdlet Set-AzVMDscExtension.

Przykłady

Przykład 1. Tworzenie pakietu .zip przekazania go do usługi Azure Storage

Publish-AzVMDscConfiguration ".\MyConfiguration.ps1"

To polecenie tworzy pakiet .zip dla danego skryptu i wszystkich modułów zasobów zależnych i przekazuje go do usługi Azure Storage.

Przykład 2. Tworzenie pakietu .zip i przechowywanie go w pliku lokalnym

Publish-AzVMDscConfiguration ".\MyConfiguration.ps1" -OutputArchivePath ".\MyConfiguration.ps1.zip"

To polecenie tworzy pakiet .zip dla danego skryptu i wszystkich modułów zasobów zależnych i przechowuje go w pliku lokalnym o nazwie .\MyConfiguration.ps1.zip.

Przykład 3: Dodawanie konfiguracji do archiwum, a następnie przekazywanie ich do magazynu

Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -SkipDependencyDetection

To polecenie dodaje konfigurację o nazwie Sample.ps1 do archiwum konfiguracji w celu przekazania do usługi Azure Storage i pomija zależne moduły zasobów.

Przykład 4. Dodawanie danych konfiguracji i konfiguracji do archiwum, a następnie przekazywanie ich do magazynu

Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -ConfigurationDataPath "C:\SampleData.psd1"

To polecenie dodaje konfigurację o nazwie Sample.ps1 i dane konfiguracji o nazwie SampleData.psd1 do archiwum konfiguracji w celu przekazania do usługi Azure Storage.

Przykład 5: Dodawanie konfiguracji, danych konfiguracji i dodatkowej zawartości do archiwum, a następnie przekazywanie ich do magazynu

Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -AdditionalPath @("C:\ContentDir1", "C:\File.txt") -ConfigurationDataPath "C:\SampleData.psd1"

To polecenie dodaje konfigurację o nazwie Sample.ps1, dane konfiguracji SampleData.psd1 i dodatkową zawartość do archiwum konfiguracji w celu przekazania do usługi Azure Storage.

Parametry

-AdditionalPath

Określa ścieżkę pliku lub katalogu do uwzględnienia w archiwum konfiguracji. Jest on pobierany do maszyny wirtualnej wraz z konfiguracją.

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

-ConfigurationDataPath

Określa ścieżkę pliku psd1, który określa dane konfiguracji. Jest on dodawany do archiwum konfiguracji, a następnie przekazywany do funkcji konfiguracji. Jest zastępowany przez ścieżkę danych konfiguracji dostarczoną za pomocą polecenia cmdlet Set-AzVMDscExtension

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

-ConfigurationPath

Określa ścieżkę pliku zawierającego co najmniej jedną konfigurację. Plik może być plikiem skryptu programu Windows PowerShell (ps1) lub plikiem modułu programu Windows PowerShell (psm1).

Type:String
Position:1
Default value:None
Required:True
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

-ContainerName

Określa nazwę kontenera usługi Azure Storage, do których zostanie przekazana konfiguracja.

Type:String
Position:4
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

-OutputArchivePath

Określa ścieżkę lokalnego pliku .zip do zapisania archiwum konfiguracji. Gdy ten parametr jest używany, skrypt konfiguracji nie jest przekazywany do usługi Azure Blob Storage.

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

-ResourceGroupName

Określa nazwę grupy zasobów, która zawiera konto magazynu.

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

-SkipDependencyDetection

Wskazuje, że to polecenie cmdlet wyklucza zależności zasobów DSC z archiwum konfiguracji.

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

-StorageAccountName

Określa nazwę konta magazynu platformy Azure używaną do przekazywania skryptu konfiguracji do kontenera określonego przez parametr ContainerName .

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

-StorageEndpointSuffix

Określa sufiks punktu końcowego magazynu.

Type:String
Position:Named
Default value:None
Required:False
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

Dane wejściowe

String

String[]

Dane wyjściowe

String