Поиск по сайту:

Get-WSManInstance (Microsoft.WSMan.Management)

Get-WSManInstance

Модуль:
Microsoft.WSMan.Management

Отображает информацию управления для экземпляра ресурса, указанного URI ресурса.

Синтаксис

Get-WSManInstance
   [-ApplicationName <String>]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Fragment <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-ResourceURI] <Uri>
   [-SelectorSet <Hashtable>]
   [-SessionOption <SessionOption>]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]
Get-WSManInstance
   [-ApplicationName <String>]
   [-BasePropertiesOnly]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Enumerate]
   [-Filter <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-Associations]
   [-ResourceURI] <Uri>
   [-ReturnType <String>]
   [-SessionOption <SessionOption>]
   [-Shallow]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Описание

Командлет Get-WSManInstance извлекает экземпляр ресурса управления, заданный универсальным идентификатором ресурса (URI) ресурса. Получаемая информация может представлять собой сложный набор данных XML, который является объектом, или простое значение. Этот командлет эквивалентен стандартной команде Get веб-служб управления (WS-Management).

Этот командлет использует уровень соединения/транспорта WS-Management для получения информации.

Примеры

Пример 1. Получите всю информацию из WMI

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="winrm"} -ComputerName "Server01"

Эта команда возвращает всю информацию, которую предоставляет инструментарий управления Windows (WMI) о службе WinRM на удаленном компьютере server01.

Пример 2. Получение статуса службы спулера

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="spooler"} -Fragment Status -ComputerName "Server01"

Эта команда возвращает только состояние службы Spooler на удаленном компьютере server01.

Пример 3. Получите ссылки на конечные точки для всех служб.

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/win32_service -ReturnType EPR

Эта команда возвращает ссылки на конечные точки, соответствующие всем службам на локальном компьютере.

Пример 4. Получите услуги, соответствующие указанным критериям.

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/* -Filter "select * from win32_service where StartMode = 'Auto' and State = 'Stopped'" -ComputerName "Server01"

Эта команда перечисляет все службы, которые соответствуют следующим критериям на удаленном компьютере Server01:

  • Тип запуска службы — Автоматический.
  • Служба остановлена.

Пример 5. Получение конфигурации прослушивателя, соответствующей критериям, на локальном компьютере.

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"}

Эта команда выводит список конфигурации прослушивателя WS-Management на локальном компьютере для прослушивателя, который соответствует критериям в наборе селекторов.

Пример 6. Получите конфигурацию прослушивателя, соответствующую критериям, на удаленном компьютере.

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"} -ComputerName "Server01"

Эта команда выводит список конфигурации прослушивателя WS-Management на удаленном компьютере server01 для прослушивателя, который соответствует критериям в наборе селекторов.

Пример 7. Получение связанных экземпляров, связанных с указанным экземпляром

Get-WSManInstance -Enumerate -Dialect Association -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

Эта команда получает связанные экземпляры, относящиеся к указанному экземпляру (winrm).

Фильтр необходимо заключить в кавычки, как показано в примере.

Пример 8. Получение экземпляров ассоциации, связанных с указанным экземпляром

Get-WSManInstance -Enumerate -Dialect Association -Associations -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

Эта команда получает экземпляры ассоциации, связанные с указанным экземпляром (winrm). Поскольку значением Dialect является ассоциация и используется параметр Associations, эта команда возвращает экземпляры ассоциации, а не связанные экземпляры.

Фильтр необходимо заключить в кавычки, как показано в примере.

Параметры

-ApplicationName

Указывает имя приложения в соединении. Значением по умолчанию параметра ApplicationName является WSMAN. Полный идентификатор удаленной конечной точки имеет следующий формат:

<транспорт>://<сервер>:<порт>/<имя приложения>

Например:

http://server01:8080/WSMAN

Службы IIS, на которых размещается сеанс, пересылают запросы с этой конечной точки указанному приложению. Эта настройка WSMAN по умолчанию подходит для большинства случаев использования. Этот параметр предназначен для использования, если несколько компьютеров устанавливают удаленные подключения к одному компьютеру, на котором работает PowerShell. В этом случае для повышения эффективности IIS размещает WS-Management.

Тип :

String

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Associations

Указывает, что этот командлет получает экземпляры ассоциации, а не связанные экземпляры. Этот параметр можно использовать только в том случае, если параметр Dialect имеет значение Association.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Authentication

Указывает механизм аутентификации, который будет использоваться на сервере. Допустимые значения этого параметра:

  • Basic — Basic — это схема, в которой имя пользователя и пароль передаются на сервер или прокси в виде открытого текста.
  • Default — использовать метод аутентификации, реализованный протоколом WS-Management. Это значение по умолчанию.
  • Дайджест. Дайджест — это схема запроса-ответа, в которой для запроса используется строка данных, указанная сервером.
  • Kerberos — клиентский компьютер и сервер выполняют взаимную проверку подлинности с помощью сертификатов Kerberos.
  • Согласование. Согласование — это схема запроса-ответа, которая согласовывает с сервером или прокси-сервером, чтобы определить схему, которая будет использоваться для аутентификации. Например, значение этого параметра позволяет путем согласования определить, используется ли протокол Kerberos или NTLM.
  • CredSSP — используйте аутентификацию поставщика поддержки безопасности учетных данных (CredSSP), которая позволяет пользователю делегировать учетные данные. Этот параметр предназначен для команд, которые выполняются на одном удаленном компьютере, но собирают данные или запускают дополнительные команды на других удаленных компьютерах.

Осторожность

CredSSP делегирует учетные данные пользователя с локального компьютера на удаленный компьютер. Такая практика увеличивает риск безопасности удаленной операции. Если удаленный компьютер взломан, то при передаче ему учетных данных эти учетные данные можно использовать для управления сетевым сеансом.

Тип :

AuthenticationMechanism

Псевдонимы:

auth, am

Принятые значения:

Нет, по умолчанию, дайджест, согласование, базовый, Kerberos, ClientCertificate, Credssp

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-BasePropertiesOnly

Указывает, что этот командлет перечисляет только те свойства, которые являются частью базового класса, указанного параметром ResourceURI. Этот параметр не имеет никакого эффекта, если указан параметр Shallow.

Тип :

SwitchParameter

Псевдонимы:

UBPO, Base

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-CertificateThumbprint

Указывает сертификат цифрового открытого ключа (X509) учетной записи пользователя, у которой есть разрешение на выполнение этого действия. Введите отпечаток сертификата.

Сертификаты используются при проверке подлинности на основе сертификатов клиентов. Их можно сопоставить только с локальными учетными записями пользователей; они не работают с доменными учетными записями.

Чтобы получить отпечаток сертификата, используйте команду Get-Item или Get-ChildItem на диске PowerShell Cert:.

Тип :

String

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-ComputerName

Указывает компьютер, на котором будет выполняться операция управления. Значением может быть полное доменное имя, имя NetBIOS или IP-адрес. Используйте имя локального компьютера, localhost или точку (.), чтобы указать локальный компьютер. Локальный компьютер используется по умолчанию. Если удаленный компьютер находится в домене, отличном от домена пользователя, необходимо использовать полное доменное имя. Вы можете передать значение этого параметра в командлет.

Тип :

String

Псевдонимы:

CN

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-ConnectionURI

Указывает конечную точку соединения. Формат этой строки следующий:

<Транспорт>://<Сервер>:<Порт>/<ИмяПриложения>

Следующая строка представляет собой правильно отформатированное значение для этого параметра:

http://Server01:8080/WSMAN

URI должен быть полностью квалифицированным.

Тип :

Ури

Псевдонимы:

CURI, CU

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Credential

Указывает учетную запись пользователя, имеющую разрешение на выполнение этого действия. По умолчанию используется текущий пользователь. Введите имя пользователя, например User01, Domain01\User01 или User@Domain.com. Или введите объект PSCredential, например тот, который возвращается командлетом Get-Credential. Когда вы вводите имя пользователя, этот командлет запрашивает пароль.

Тип :

PSCredential

Псевдонимы:

cred, c

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-Dialect

Указывает диалект, который будет использоваться в предикате фильтра. Это может быть любой диалект, поддерживаемый удаленной службой. Для диалектного URI можно использовать следующие псевдонимы:

  • WQL — http://schemas.microsoft.com/wbem/wsman/1/WQL
  • Селектор — http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
  • Ассоциация — http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter
Тип :

Ури

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Enumerate

Указывает, что этот командлет возвращает все экземпляры ресурса управления.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

True

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Filter

Указывает выражение фильтра для перечисления. Если вы укажете этот параметр, вы также должны указать Диалект.

Допустимые значения этого параметра зависят от диалекта, указанного в Dialect. Например, если Диалект — это WQL, параметр Filter должен содержать строку, а эта строка должна содержать допустимый запрос WQL, например следующий запрос:

"Select * from Win32_Service where State != Running"

Если Диалект имеет значение «Ассоциация», Фильтр должен содержать строку, а строка должна содержать допустимый фильтр, например следующий фильтр:

-filter:Object=EPR\[;AssociationClassName=AssocClassName\]\[;ResultClassName=ClassName\]\[;Role=RefPropertyName\]\[;ResultRole=RefPropertyName\]}
Тип :

String

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Fragment

Указывает раздел внутри экземпляра, который необходимо обновить или получить для указанной операции. Например, чтобы получить статус службы спулера, укажите следующее:

-Fragment Status
Тип :

String

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-OptionSet

Указывает набор переключателей службы для изменения или уточнения характера запроса. Они напоминают переключатели, используемые в оболочках командной строки, поскольку они зависят от службы. Можно указать любое количество опций.

В следующем примере демонстрируется синтаксис, который передает значения 1, 2 и 3 для параметров a, b и c:

-OptionSet @{a=1;b=2;c=3}
Тип :

Хэш-таблица

Псевдонимы:

OS

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-Port

Указывает порт, который будет использоваться при подключении клиента к службе WinRM. Если транспортом является HTTP, порт по умолчанию — 80. Если транспортом является HTTPS, порт по умолчанию — 443.

Если вы используете HTTPS в качестве транспорта, значение параметра ComputerName должно соответствовать общему имени сертификата сервера (CN). Однако если параметр SkipCNCheck указан как часть параметра SessionOption, общее имя сертификата сервера не обязательно должно совпадать с именем хоста сервера. Параметр SkipCNCCheck следует использовать только для доверенных компьютеров.

Тип :

Int32

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-ResourceURI

Указывает URI класса или экземпляра ресурса. URI идентифицирует конкретный тип ресурса, например диски или процессы, на компьютере.

URI состоит из префикса и пути к ресурсу. Например:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor
Тип :

Ури

Псевдонимы:

RURI

Позиция:

0

Значение по умолчанию:

None

Необходимый:

True

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-ReturnType

Указывает тип возвращаемых данных. Допустимые значения этого параметра:

    Object
    EPR
    ObjectAndEPR

Значение по умолчанию — Object.

Если вы укажете Object или не укажете этот параметр, этот командлет вернет только объекты. Если вы укажете ссылку на конечную точку (EPR), этот командлет вернет только ссылки на конечные точки объектов. Ссылки на конечные точки содержат информацию об URI ресурса и селекторах для экземпляра. Если вы укажете ObjectAndEPR, этот командлет вернет как объект, так и связанные с ним ссылки на конечные точки.

Тип :

String

Псевдонимы:

RT

Принятые значения:

объект, эпр, объектандепр

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-SelectorSet

Указывает набор пар значений, которые используются для выбора конкретных экземпляров ресурса управления. Параметр SelectorSet используется, когда существует более одного экземпляра ресурса. Значение параметра SelectorSet должно быть хеш-таблицей.

В следующем примере показано, как ввести значение для этого параметра:

-SelectorSet @{Name="WinRM";ID="yyy"}
Тип :

Хэш-таблица

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-SessionOption

Указывает расширенные параметры для сеанса WS-Management. Введите объект SessionOption, созданный с помощью командлета New-WSManSessionOption. Для получения дополнительных сведений о доступных параметрах введите Get-Help New-WSManSessionOption.

Тип :

SessionOption

Псевдонимы:

SO

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Shallow

Указывает, что этот командлет возвращает только экземпляры базового класса, указанного в URI ресурса. Если вы не укажете этот параметр, этот командлет вернет экземпляры базового класса, указанного в URI, и во всех его производных классах.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-UseSSL

Указывает, что для установления соединения с удаленным компьютером используется протокол Secure Sockets Layer (SSL). По умолчанию SSL не используется.

WS-Management шифрует все содержимое Windows PowerShell, передаваемое по сети. Параметр UseSSL позволяет указать дополнительную защиту HTTPS вместо HTTP. Если SSL недоступен на порту, который используется для подключения, и вы укажете этот параметр, команда завершится неудачно.

Тип :

SwitchParameter

Псевдонимы:

SSL

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

Входы

Нет

Вы не можете передавать объекты в этот командлет.

Выходы

XmlElement

Этот командлет возвращает объект XMLElement.