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

Publish-AzVMDscConfiguration

Модуль:
Az.Compute Module

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

Синтаксис

UploadArchive (по умолчанию) 

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

CreateArchive 

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

Описание

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

Примеры

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

Publish-AzVMDscConfiguration ".\MyConfiguration.ps1"

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметры

-AdditionalPath

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

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ConfigurationDataPath

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ConfigurationPath

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ContainerName

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UploadArchive
Position:4
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DefaultProfile

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

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-OutputArchivePath

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ConfigurationArchivePath

Наборы параметров

CreateArchive
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ResourceGroupName

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UploadArchive
Position:2
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-SkipDependencyDetection

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-StorageAccountName

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UploadArchive
Position:3
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-StorageEndpointSuffix

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UploadArchive
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

String

String

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

String