Set-SmaVariable

Модуль:
Microsoft.SystemCenter.ServiceManagementAutomation Module

Создает или изменяет переменную в SMA.

Синтаксис

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

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
Default value:None
Допустимые значения:Basic, Windows
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Confirm

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

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

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

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

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

-Credential

Указывает объект PSCredential для подключения к веб-службе SMA. Чтобы получить объект учетных данных, используйте командлет Get-Credential. Дополнительные сведения см. в Get-Help Get-Credential.

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

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

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

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

-Description

Содержит описание переменной.

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

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

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

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

-Encrypted

Указывает, что этот командлет шифрует переменную.

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

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

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

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

-Force

Изменяет переменную, не запрашивая подтверждение. Командлет запрашивает подтверждение, прежде чем продолжить, если вы предоставляете SecureString в качестве значения параметра value. Этот командлет также запрашивает, если значение содержит объект с SecureString в качестве поля, и параметр Encrypted не используется.

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

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

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

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

-Name

Задает имя переменной.

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

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

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

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

-Port

Указывает номер порта веб-службы SMA.

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

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

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

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

-Value

Задает значение переменной.

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

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

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

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

-WebServiceEndpoint

Указывает конечную точку в качестве URL-адреса веб-службы SMA. Необходимо включить протокол, например http:// или https://.

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

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

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

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов: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.