Set-SmaVariable
Создает или изменяет переменную в SMA.
Синтаксис
Set-SmaVariable
-Name <String>
-Value <Object>
[-Description <String>]
[-Encrypted]
[-Force]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Set-SmaVariable создает или изменяет переменную в службе автоматизации управления системой (SMA). Укажите имя переменной и значение.
Чтобы зашифровать переменную, используйте параметр Encrypted. После создания невозможно изменить зашифрованное состояние переменной. Этот командлет завершится ошибкой, если вы используете параметр Encrypted в существующей нешифрованной переменной.
Примеры
Пример 1. Назначение значения переменной
PS C:\> Set-SmaVariable -Name "Variable01" -Value "String07" -WebServiceEndpoint "https://contoso.com/app01" -Encrypted
Эта команда назначает значение String07 переменной с именем Variable01 для указанной конечной точки веб-службы. Так как команда задает параметр Encrypted, он шифрует переменную.
Параметры
-AuthenticationType
Указывает тип проверки подлинности. Допустимые значения:
- Основной
- Виндоус
Значением по умолчанию для этого параметра является Windows.
При использовании базовой проверки подлинности необходимо указать учетные данные с помощью параметра учетных данных
Тип: | String |
Допустимые значения: | Basic, Windows |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Credential
Указывает объект PSCredential для подключения к веб-службе SMA.
Чтобы получить объект учетных данных, используйте командлет Get-Credential.
Дополнительные сведения см. в Get-Help Get-Credential
.
Тип: | PSCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Description
Содержит описание переменной.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Encrypted
Указывает, что этот командлет шифрует переменную.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Force
Изменяет переменную, не запрашивая подтверждение. Командлет запрашивает подтверждение, прежде чем продолжить, если вы предоставляете SecureString в качестве значения параметра value. Этот командлет также запрашивает, если значение содержит объект с SecureString в качестве поля, и параметр Encrypted не используется.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Name
Задает имя переменной.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Port
Указывает номер порта веб-службы SMA.
Тип: | Int32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Value
Задает значение переменной.
Тип: | Object |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WebServiceEndpoint
Указывает конечную точку в качестве URL-адреса веб-службы SMA. Необходимо включить протокол, например http:// или https://.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |