Поделиться через


Publish-AzureRmVMDscConfiguration

Отправляет скрипт DSC в хранилище BLOB-объектов Azure.

Предупреждение

Модуль AzureRM PowerShell официально объявлен устаревшим с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

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

Описание

Командлет Publish-AzureRmVMDscConfiguration отправляет скрипт требуемой конфигурации состояния (DSC) в хранилище BLOB-объектов Azure, которое позже можно применить к виртуальным машинам Azure с помощью командлета Set-AzureRmVMDscExtension.

Примеры

Пример 1. Создание пакета .zip отправки в хранилище Azure

PS C:\> Publish-AzureRmVMDscConfiguration ".\MyConfiguration.ps1"

Эта команда создает пакет .zip для данного скрипта и всех зависимых модулей ресурсов и отправляет его в хранилище Azure.

Пример 2. Создание пакета .zip и его хранение в локальном файле

PS C:\> Publish-AzureRmVMDscConfiguration ".\MyConfiguration.ps1" -OutputArchivePath ".\MyConfiguration.ps1.zip"

Эта команда создает пакет .zip для данного скрипта и всех зависимых модулей ресурсов и сохраняет его в локальном файле с именем .\MyConfiguration.ps1.zip.

Пример 3. Добавьте конфигурацию в архив и отправьте ее в хранилище.

PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -SkipDependencyDetection

Эта команда добавляет конфигурацию с именем Sample.ps1 в архив конфигурации для отправки в хранилище Azure и пропускает зависимые модули ресурсов.

Пример 4. Добавление данных конфигурации и конфигурации в архив, а затем передача данных в хранилище

PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -ConfigurationDataPath "C:\SampleData.psd1"

Эта команда добавляет конфигурацию sample.ps1 и данные конфигурации с именем SampleData.psd1 в архив конфигурации для отправки в хранилище Azure.

Пример 5. Добавление конфигурации, данных конфигурации и дополнительного содержимого в архив, а затем отправка его в хранилище

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

Эта команда добавляет конфигурацию sample.ps1, данные конфигурации SampleData.psd1 и дополнительное содержимое в архив конфигурации для отправки в хранилище Azure.

Параметры

-AdditionalPath

Указывает путь к файлу или каталогу для включения в архив конфигурации. Он загружается на виртуальную машину вместе с конфигурацией.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ConfigurationDataPath

Указывает путь к PSD1-файлу, который указывает данные для конфигурации. Он добавляется в архив конфигурации, а затем передается в функцию конфигурации. Он получает перезапись путем данных конфигурации, предоставленным с помощью командлета Set-AzureRmVMDscExtension

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ConfigurationPath

Указывает путь к файлу, который содержит одну или несколько конфигураций. Файл может быть файлом скрипта Windows PowerShell (PS1) или файлом модуля Windows PowerShell (PSM1).

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ContainerName

Указывает имя контейнера хранилища Azure, в который отправляется конфигурация.

Тип:String
Position:4
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Тип:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

Принудительное выполнение команды без запроса на подтверждение пользователем.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OutputArchivePath

Указывает путь к локальному .zip файлу для записи архива конфигурации. Если этот параметр используется, скрипт конфигурации не передается в хранилище BLOB-объектов Azure.

Тип:String
Aliases:ConfigurationArchivePath
Position:2
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ResourceGroupName

Указывает имя группы ресурсов, содержащей учетную запись хранения.

Тип:String
Position:2
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SkipDependencyDetection

Указывает, что этот командлет исключает зависимости ресурсов DSC из архива конфигурации.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-StorageAccountName

Указывает имя учетной записи хранения Azure, которая используется для отправки скрипта конфигурации в контейнер, указанный параметром ContainerName .

Тип:String
Position:3
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-StorageEndpointSuffix

Указывает суффикс конечной точки хранилища.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

String

String[]

Выходные данные

String