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. Create объекта параметров сеанса CIM для DCOM
В этом примере создается объект параметров сеанса CIM для протокола DCOM и сохраняется в переменной с именем $so
. Затем содержимое переменной передается командлету New-CimSession
.
New-CimSession
затем создает новый сеанс CIM с удаленным сервером с именем Server01, используя параметры, определенные в переменной .
$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so
Пример 2. Create объекта параметров сеанса CIM для WsMan
В этом примере создается объект параметров сеанса CIM для протокола WsMan. Объект содержит конфигурацию для режима проверки подлинности Kerberos, заданного параметром ProxyAuthentication, учетные данные, заданные параметром ProxyCredential, и указывает, что команда заключается в пропуске проверка ЦС, пропуске проверка CN и использовании SSL.
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl
Пример 3. Create объекта параметров сеанса 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 подключается к службе, имя субъекта-службы которой содержит номер порта службы. Этот тип подключения не является распространенным.
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
командлет использует значение Impersonate.
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, использует функцию Com)PacketIntegrity . По умолчанию для всех сеансов 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 или InternetExplorer.
Значение этого параметра по умолчанию — InternetExplorer.
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.