Get-Credential
Получает объект хранения учетных данных на основе имени пользователя и пароля.
Синтаксис
Get-Credential [-Credential] <PSCredential> [<CommonParameters>]
Описание
Командлет Get-Credential создает объект хранения учетных данных для указанных имени пользователя и пароля. Объект хранения учетных данных можно использовать в операциях, связанных с безопасностью.
Командлет запрашивает у пользователя пароль или имя пользователя и пароль. Пользователи получают запрос с помощью диалогового окна или командной строки (в зависимости от параметров системного реестра).
Параметры
-Credential <PSCredential>
Указывает имя пользователя для учетных данных, например "User01" или "Domain01\User01". Имя параметра ("Credential") необязательно.
При отправке команды появляется запрос на ввод пароля.
Если ввести имя пользователя без указания домена, командлет Get-Credential вставит перед именем обратную косую черту.
Если параметр пропущен, программа просит ввести имя пользователя и пароль.
Обязательно? |
true |
Позиция? |
1 |
Значение по умолчанию |
нет |
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
Входные данные |
None Передать входные данные этому командлету по конвейеру невозможно. |
Выходные данные |
System.Management.Automation.PSCredential Get-Credential возвращает объект хранения учетных данных. |
Примечания
Созданный с помощью Get-Credential объект PSCredential можно использовать в командлетах, которые запрашивают проверку подлинности пользователя, в частности, которые используют параметр Credential.
Параметр Credential не поддерживается поставщиками, которые поставляются с Windows PowerShell. Однако можно использовать параметр Credential с Get-WmiObject, так как он напрямую вызывает Microsoft .NET Framework.
Пример 1
C:\PS>$c = Get-Credential
Описание
-----------
Эта команда получает объект хранения учетных данных и сохраняет его в переменной $c.
При вводе команды на экране появляется диалоговое окно с запросом имени пользователя и пароля. Когда запрошенные данные введены, командлет создает объект PSCredential, представляющий учетные данные пользователя, и сохраняет его в переменной $c.
Объект можно использовать в качестве входного для командлетов, которые запрашивают проверку подлинности пользователя, в частности, которые используют параметр Credential. Однако поставщики, поставляемые с Windows PowerShell, не поддерживают параметр Credential.
Пример 2
C:\PS>$c = Get-Credential
C:\PS>Get-WmiObject Win32_DiskDrive -ComputerName Server01 -Credential $c
Описание
-----------
Эти команды используют объект хранения учетных данных из Get-Credential для проверки подлинности пользователя удаленного компьютера, чтобы они могли использовать инструментарий управления Windows (WMI) для управления компьютером.
Первая команда получает объект хранения учетных данных и сохраняет его в переменной $c. Вторая команда использует объект хранения учетных данных в команде Get-WmiObject. Эта команда получает данные о дисковых накопителях на компьютере Server01.
Пример 3
C:\PS>C:\PS>Get-WmiObject Win32_BIOS -ComputerName Server01 '
Credential (get-credential Domain01\User01)
Описание
-----------
Эта команда показывает, как включить команду Get-Credential в команду Get-WmiObject.
Эта команда использует командлет Get-WmiObject, чтобы получить данные о BIOS компьютера Server01. Она использует параметр Credential для проверки подлинности пользователя, Domain01\User01, и команду Get-Credential в качестве значения параметра Credential.
Пример 4
C:\PS>$c = Get-Credential -credential User01
C:\PS>$c.Username
\User01
Описание
-----------
В этом примере создаются учетные данные, включающие имя пользователя без имени домена. Она показывает, что командлет Get-Credential вставляет перед именем пользователя обратную косую черту.
Первая команда получает учетные данные, включающие имя пользователя User01, и сохраняет их в переменной $c.
Вторая команда выводит значение свойства Username полученного объекта хранения учетных данных.
Пример 5
C:\PS>$credential = $host.ui.PromptForCredential("Need credentials", "Please enter your user name and password.", "", "NetBiosUserName")
Описание
-----------
Эта команда с помощью метода PromptForCredential выдает пользователю запрос на ввод имени пользователя и пароля. Эта команда сохраняет полученные учетные данные в переменной $credential.
PromptForCredential — это альтернатива использованию командлета Get-Credential. При использовании метода PromptForCredential можно задать заголовок, сообщения, а также имя пользователя, появляющиеся в окне сообщения.
Пример 6
C:\PS>Set-ItemProperty 'HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds' ConsolePrompting $true
Описание
-----------
По умолчанию запрос у пользователя имени пользователя и пароля осуществляется с помощью диалогового окна. Чтобы выполнить этот запрос с помощью командной строки, измените реестр, от имени администратора выполнив данную команду Windows PowerShell.
Чтобы запрос выводился с помощью диалогового окна, выполните ту же команду, изменив значение параметра на "ConsolePrompting $false".