New-SCScriptCommandSetting

Модуль:
VirtualMachineManager Module

Создает объект настроек для команды скрипта.

Синтаксис

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

New-SCScriptCommandSetting
    [-AlwaysReboot <Boolean>]
    [-FailOnMatch]
    [-WarnAndContinueOnMatch]
    [-MatchExitCode <String>]
    [-MatchStandardError <String>]
    [-MatchStandardOutput <String>]
    [-PersistStandardErrorPath <String>]
    [-PersistStandardOutputPath <String>]
    [-MatchRebootExitCode <String>]
    [-RestartScriptOnExitCodeReboot <Boolean>]
    [-WorkingDirectory <String>]
    [-CommandMayReboot]
    [-RestartOnRetry <Boolean>]
    [<CommonParameters>]

Описание

Командлет New-SCScriptCommandSetting создает объект параметров для команды скрипта.

Примеры

Пример 1: Добавление настройки рабочего каталога в команду скрипта

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $ScriptCommand = Get-SCScriptCommand -ApplicationProfile $AppProfile | where {$_.Name -eq "PostInstall"}
PS C:\> $ScriptSetting = New-SCScriptCommandSetting -WorkingDirectory "Working_Folder_02"
PS C:\> Set-SCScriptCommand -ScriptCommand $ScriptCommand -ScriptCommandSetting $ScriptSetting

Первая команда получает объект профиля приложения с именем SvcWebAppProfile01 и сохраняет объект в переменной $AppProfile.

Вторая команда получает объект команды script с именем PostInstall для профиля приложения, хранящегося в $AppProfile.

Третья команда создает новую настройку команды скрипта, которая устанавливает рабочий каталог в значение Working_Folder_02, а затем сохраняет объект в переменной $ScriptSetting.

Последняя команда обновляет рабочий каталог для команды script, хранящейся в $ScriptCommand to be Working_Folder_02 (значение $ScriptSetting).

Параметры

-AlwaysReboot

Указывает, следует ли всегда перезапускать компьютер или виртуальную машину после завершения выполнения сценария.

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

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

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

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

-CommandMayReboot

Указывает, что команда script может перезагрузить компьютер или виртуальную машину.

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

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

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

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

-FailOnMatch

Указывает, что действие, выполняемое при совпадении с политикой сбоя, должно завершиться сбоем.

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

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

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

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

-MatchExitCode

Указывает код выхода из политики сбоя.

Пример формата: -MatchExitCode "[1-9][0-9]*"

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

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

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

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

-MatchRebootExitCode

Указывает соответствие политики перезапуска коду выхода.

Пример формата: -MatchRebootExitCode "{1641}|{3010}|{3011}"

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

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

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

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

-MatchStandardError

Указывает стандартную ошибку политики сбоев.

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

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

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

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

-MatchStandardOutput

Указывает стандартные выходные данные политики сбоев.

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

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

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

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

-PersistStandardErrorPath

Указывает путь к файлу для хранения стандартной ошибки.

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

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

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

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

-PersistStandardOutputPath

Указывает путь к файлу для хранения стандартных выходных данных.

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

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

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

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

-RestartOnRetry

Указывает, перезапускается ли сценарий при перезапуске задания VMM, если предыдущее задание было сбоем из-за сбоя сценария при использовании в сочетании с New-SCScriptCommandSetting или Set-SCScriptCommandSetting.

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

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

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

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

-RestartScriptOnExitCodeReboot

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

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

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

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

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

-WarnAndContinueOnMatch

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

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

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

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

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

-WorkingDirectory

Указывает рабочий каталог для команды скрипта.

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

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

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

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

CommonParameters

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

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

ScriptCommandSetting

Этот командлет возвращает объект ScriptCommandSetting .