Командлет New-SmaConnection создает экземпляр подключения в службе автоматизации управления службами (SMA).
Примеры
Пример 1. Создание подключения
PS C:\> New-SmaConnection -WebServiceEndpoint "https://contoso.com/app01" -Name "MyConnection" -ConnectionTypeName "MyConnectionType" -Description "This is a new connection" -ConnectionFieldValues @{ "Hostname"="Computer01"; "Username"="PattiFuller"; Password="passw0rd!"}
Эта команда создает подключение с именем MyConnection с помощьюимени , ConnectionTypeNameи параметров ConnectionFieldValues.
Осторожность
Корпорация Майкрософт рекомендует использовать самый безопасный поток проверки подлинности. Поток проверки подлинности, описанный в этом примере, требует очень высокого уровня доверия к приложению и несет риски, которые отсутствуют в других потоках.
Параметры
-AuthenticationType
Указывает тип проверки подлинности.
Допустимые значения:
Основной
Виндоус
Значением по умолчанию для этого параметра является Windows.
При использовании базовой проверки подлинности необходимо указать учетные данные с помощью параметра учетных данных .
Свойства параметра
Тип:
String
Default value:
None
Допустимые значения:
Basic, Windows
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-ConnectionFieldValues
Указывает хэш-таблицу, содержащую пары ключей и значений.
Ключи представляют поля подключения для указанного типа подключения.
Значения представляют определенные значения для каждого поля подключения для экземпляра подключения.
Свойства параметра
Тип:
Hashtable
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-ConnectionTypeName
Указывает тип подключения.
Свойства параметра
Тип:
String
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
True
Значение из конвейера:
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
-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
-WebServiceEndpoint
Указывает конечную точку в качестве URL-адреса веб-службы SMA.
Необходимо включить протокол, например http:// или https://.
Свойства параметра
Тип:
String
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
True
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.