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"

Эта команда возвращает только состояние службы очереди печати на удаленном компьютере 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 задано значение association и используется параметр Associations, эта команда возвращает экземпляры ассоциаций, а не связанные экземпляры.

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

Параметры

-ApplicationName

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

Например: http://server01:8080/WSMAN

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Associations

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Authentication

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

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

Внимание

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

Type:	AuthenticationMechanism
Aliases:	auth, am
Accepted values:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BasePropertiesOnly

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

Type:	SwitchParameter
Aliases:	UBPO, Base
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

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

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

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

Type:	String
Aliases:	CN
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionURI

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

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

http://Server01:8080/WSMAN

Значение URI должно быть указано полностью.

Type:	Uri
Aliases:	CURI, CU
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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

Type:	PSCredential
Aliases:	cred, c
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Enumerate

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

Задает выражение фильтра для перечисления. При указании этого параметра необходимо также указать параметр Dialect.

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

"Select * from Win32_Service where State != Running"

Если параметр Dialect имеет значение Association, параметр Filter должен содержать строку с допустимым запросом WQL, например следующего вида:

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Fragment

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

-Fragment Status

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OptionSet

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

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

-OptionSet @{a=1;b=2;c=3}

Type:	Hashtable
Aliases:	OS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Port

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

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	Uri
Aliases:	RURI
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ReturnType

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

Object
EPR
ObjectAndEPR

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

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

Type:	String
Aliases:	RT
Accepted values:	object, epr, objectandepr
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SelectorSet

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

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

-SelectorSet @{Name="WinRM";ID="yyy"}

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SessionOption

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

Type:	SessionOption
Aliases:	SO
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Shallow

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSSL

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

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

Type:	SwitchParameter
Aliases:	SSL
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Входные данные

None

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

Выходные данные

XmlElement

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

Get-WSManInstance

Синтаксис

Описание

Примеры

Пример 1. Получение всех данных из инструментария WMI

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

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

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

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

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

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

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

Параметры

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Входные данные

Выходные данные

Обратная связь

Дополнительные ресурсы

Get-WSManInstance

Синтаксис

Описание

Примеры

Пример 1. Получение всех данных из инструментария WMI

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

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

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

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

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

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

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

Параметры

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Входные данные

Выходные данные

Связанные ссылки

Обратная связь

Дополнительные ресурсы