New-CimSessionOption
Задает дополнительные параметры для командлета New-CimSession.
Синтаксис
New-CimSessionOption
[-Protocol] <ProtocolType>
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>]
New-CimSessionOption
[-NoEncryption]
[-SkipCACheck]
[-SkipCNCheck]
[-SkipRevocationCheck]
[-EncodePortInServicePrincipalName]
[-Encoding <PacketEncoding>]
[-HttpPrefix <Uri>]
[-MaxEnvelopeSizeKB <UInt32>]
[-ProxyAuthentication <PasswordAuthenticationMechanism>]
[-ProxyCertificateThumbprint <String>]
[-ProxyCredential <PSCredential>]
[-ProxyType <ProxyType>]
[-UseSsl]
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>]
New-CimSessionOption
[-Impersonation <ImpersonationType>]
[-PacketIntegrity]
[-PacketPrivacy]
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>]
Описание
Этот командлет доступен только на платформе Windows.
Командлет New-CimSessionOption
создает экземпляр объекта параметров сеанса CIM. Объект параметров сеанса CIM используется в качестве входных данных командлета New-CimSession
для указания параметров сеанса CIM.
Этот командлет имеет два набора параметров, один для параметров WsMan и один для параметров распределенной объектной модели компонентов (DCOM). В зависимости от используемых параметров командлет возвращает либо экземпляр параметров сеанса DCOM, либо возвращает параметры сеанса WsMan.
Примеры
Пример 1. Создание объекта параметров сеанса CIM для DCOM
В этом примере создается объект параметров сеанса CIM для протокола DCOM и сохраняет его в переменной с именем $so
. Затем содержимое переменной передается командлету New-CimSession
.
New-CimSession
затем создает новый сеанс CIM с удаленным сервером с именем Server01, используя параметры, определенные в переменной.
$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so
Пример 2. Создание объекта параметров сеанса CIM для WsMan
В этом примере создается объект параметров сеанса CIM для протокола WsMan. Объект содержит конфигурацию для режима проверки подлинности Kerberos, указанного параметром ProxyAuthentication, учетными данными, указанными параметром ProxyCredential, и указывает, что команда заключается в том, чтобы пропустить ЦС проверка, пропустить проверка CN и использовать SSL.
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl
Пример 3. Создание объекта параметров сеанса CIM с указанным языком и региональными параметрами
New-CimSessionOption -Culture Fr-Fr -Protocol Wsman
В этом примере указывается язык и региональные параметры, используемые для сеанса CIM. По умолчанию язык и региональные параметры клиента используются при выполнении операций. Однако язык и региональные параметры по умолчанию можно переопределить с помощью параметра Culture .
Параметры
-Culture
Указывает язык и региональные параметры пользовательского интерфейса, используемые для сеанса CIM. Укажите значение этого параметра с помощью одного из следующих форматов:
- Имя языка и региональных параметров в
<languagecode2>-<country/regioncode2>
формате, например "EN-US". - Переменная, содержащая объект CultureInfo .
- Команда, которая получает объект CultureInfo , например Get-Culture
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EncodePortInServicePrincipalName
Указывает, что подключение Kerberos подключается к службе, имя субъекта-службы (SPN) которого включает номер порта службы. Этот тип подключения не распространен.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Encoding
Задает кодировку, используемую для протокола WsMan. Допустимые значения для этого параметра: default, Utf8 или Utf16.
Type: | PacketEncoding |
Accepted values: | Default, Utf8, Utf16 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HttpPrefix
Указывает часть URL-адреса HTTP после имени компьютера и номера порта. Изменение этого не распространено. По умолчанию значение этого параметра равно /wsman.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Impersonation
Создает сеанс DCOM в инструментарии управления Windows (WMI) с помощью олицетворения.
Допустимые значения для этого параметра:
- По умолчанию: DCOM может выбрать уровень олицетворения с помощью обычного алгоритма согласования безопасности.
- Нет: клиент является анонимным на сервере. Серверный процесс может олицетворить клиента, но маркер олицетворения не содержит никакой информации и не может использоваться.
- Определение: позволяет объектам запрашивать учетные данные вызывающего объекта.
- Олицетворения: позволяет объектам использовать учетные данные вызывающего объекта.
- Делегат. Позволяет объектам разрешать другим объектам использовать учетные данные вызывающего объекта.
Если олицетворение не указано, New-CimSession
командлет использует значение олицетворения.
Type: | ImpersonationType |
Accepted values: | Default, None, Identify, Impersonate, Delegate |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxEnvelopeSizeKB
Задает ограничение размера XML-сообщений WsMan для любого направления.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoEncryption
Указывает, что шифрование данных отключено.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PacketIntegrity
Указывает, что сеанс DCOM, созданный для WMI, использует функцию packetIntegrity для объектной модели компонента (COM). По умолчанию все сеансы CIM, созданные с помощью DCOM, имеют параметр PacketIntegrity значение True.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PacketPrivacy
Создает сеанс DCOM для WMI с помощью COM PacketPrivacy. По умолчанию все сеансы CIM, созданные с помощью DCOM, имеют для параметра PacketPrivacy значение true.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Protocol
Указывает протокол, который необходимо использовать. Допустимые значения для этого параметра: DCOM, Default или Wsman.
Type: | ProtocolType |
Accepted values: | Dcom, Default, Wsman |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyAuthentication
Указывает метод проверки подлинности, используемый для разрешения прокси-сервера. Допустимые значения этого параметра: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain или CredSsp.
Type: | PasswordAuthenticationMechanism |
Accepted values: | Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCertificateThumbprint
Указывает сертификат цифрового открытого ключа (x.509) учетной записи пользователя для проверки подлинности прокси-сервера. Введите отпечаток сертификата. Сертификаты используются при проверке подлинности на основе сертификата клиента. Они могут быть сопоставлены только с локальными учетными записями пользователей, и они не работают с учетными записями домена.
Чтобы получить отпечаток сертификата, используйте Get-Item
Get-ChildItem
командлеты в диске PowerShell Cert:
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCredential
Задает учетные данные, используемые для аутентификации прокси-сервера. Введите одно из следующих значений.
- Переменная, содержащая объект PSCredential.
- Команда, которая получает объект PSCredential, например
Get-Credential
Если этот параметр не задан, нельзя указать учетные данные.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyType
Указывает используемый механизм разрешения имен узла. Допустимые значения для этого параметра: None, WinHttp, Auto или Internet Обозреватель.
Значение по умолчанию этого параметра — Internet Обозреватель.
Type: | ProxyType |
Accepted values: | None, WinHttp, Auto, InternetExplorer |
Position: | Named |
Default value: | InternetExplorer |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkipCACheck
Указывает, что при подключении по протоколу HTTPS клиент не проверяет, подписан ли сертификат сервера доверенным центром сертификации (ЦС).
Используйте этот параметр, только если удаленный компьютер является доверенным с помощью другого механизма, например, когда удаленный компьютер является частью сети, которая физически безопасна и изолирована, или когда удаленный компьютер указан в качестве доверенного узла в конфигурации WinRM.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkipCNCheck
Указывает, что общее имя сертификата (CN) сервера не требуется совпадать с именем узла сервера. Используйте этот параметр для удаленных операций только с доверенными компьютерами, используюющими протокол HTTPS.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkipRevocationCheck
Указывает, что отзыв проверка для сертификатов сервера пропускается. Используйте этот параметр только для доверенных компьютеров.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UICulture
Указывает язык и региональные параметры пользовательского интерфейса, используемые для сеанса CIM. Укажите значение этого параметра с помощью одного из следующих форматов:
- Имя языка и региональных параметров в
<languagecode2>-<country/regioncode2>
формате, например "EN-US". - Переменная, содержащая объект CultureInfo.
- Команда, которая получает объект CultureInfo, например
Get-Culture
.
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UseSsl
Указывает, что ssl следует использовать для установления подключения к удаленному компьютеру. По умолчанию SSL не используется. WsMan шифрует все содержимое, передаваемое по сети, даже при использовании ПРОТОКОЛА HTTP.
Этот параметр позволяет указать дополнительную защиту HTTPS вместо HTTP. Если SSL недоступен на порту, используемом для подключения, и этот параметр указан, команда завершается ошибкой.
Этот параметр рекомендуется использовать только в том случае, если параметр PacketPrivacy не указан.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Входные данные
None
Невозможно передать объекты в этот командлет.
Выходные данные
Этот командлет возвращает объект, содержащий сведения о параметрах сеанса CIM.
Примечания
PowerShell включает следующие псевдонимы для New-CimSessionOption
:
- Windows:
ncso
Этот командлет доступен только на платформах Windows.
Связанные ссылки
PowerShell
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по