Get-Credential

Modül:

Microsoft.PowerShell.Security Module

Kullanıcı adı ve parola temelinde bir kimlik bilgisi nesnesi alır.

Syntax

CredentialSet (Varsayılan)

Get-Credential
    [-Credential] <PSCredential>
    [<CommonParameters>]

MessageSet

Get-Credential
    [[-UserName] <String>]
    -Message <String>
    [<CommonParameters>]

Description

Get-Credential cmdlet'i, belirtilen kullanıcı adı ve parola için bir kimlik bilgisi nesnesi oluşturur. Kimlik bilgisi nesnesini güvenlik işlemlerinde kullanabilirsiniz.

PowerShell 3.0'dan başlayarak, İleti parametresini kullanarak iletişim kutusunda kullanıcıdan adını ve parolasını isteyen özelleştirilmiş bir ileti belirtebilirsiniz.

Get-Credential cmdlet'i kullanıcıdan bir parola ya da kullanıcı adı ve parola talep eder. Varsayılan olarak, kullanıcıdan istemde bulunan bir kimlik doğrulama iletişim kutusu görüntülenir. Ancak, PowerShell konsolu gibi bazı konak programlarında, bir kayıt defteri girdisini değiştirerek komut satırında kullanıcıya sorabilirsiniz. Bu kayıt defteri girdisi hakkında daha fazla bilgi için notlara ve örneklere bakın.

Örnekler

Örnek 1

$c = Get-Credential

Bu komut bir kimlik bilgisi nesnesi alır ve $c değişkenine kaydeder.

Komutu girdiğinizde, kullanıcı adı ve parola isteyen bir iletişim kutusu görüntülenir. İstenen bilgileri girdiğinizde, cmdlet kullanıcının kimlik bilgilerini temsil eden bir PSCredential nesnesi oluşturur ve $c değişkenine kaydeder.

Kimlik Bilgisi parametresine sahip olanlar gibi, kullanıcı kimlik doğrulaması isteyen cmdlet'lere giriş olarak nesnesini kullanabilirsiniz. Ancak, PowerShell ile yüklenen bazı sağlayıcılar Kimlik Bilgisi parametresini desteklemez.

Örnek 2

$c = Get-Credential -Credential User01
$c.Username
User01

Bu örnek, etki alanı adı olmayan bir kullanıcı adı içeren bir kimlik bilgisi oluşturur.

İlk komut User01 kullanıcı adına sahip bir kimlik bilgisi alır ve $c değişkeninde depolar. İkinci komut, sonuçta elde edilen kimlik bilgisi nesnesinin Username özelliğinin değerini görüntüler.

Örnek 3

$Credential = $Host.UI.PromptForCredential(
    "Need credentials", "Please enter your user name and password.", "", "NetBiosUserName")

Bu komut PromptForCredential yöntemini kullanarak kullanıcıdan kullanıcı adını ve parolasını ister. komutu, elde edilen kimlik bilgilerini $Credential değişkenine kaydeder.

PromptForCredential yöntemi, Get-Credential cmdlet'ini kullanmaya alternatiftir. PromptForCredentialkullandığınızda, ileti kutusunda görünen resim yazısını, iletileri ve kullanıcı adını belirtebilirsiniz.

Daha fazla bilgi için SDK'daki PromptForCredential belgelerine bakın.

Örnek 4

Set-ItemProperty 'HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds' -Name ConsolePrompting -Value $true

Bu örnekte, kullanıcıdan bir iletişim kutusu yerine komut satırında istenmesi için kayıt defterinin nasıl değiştirileceği gösterilmektedir.

komutu ConsolePrompting kayıt defteri girdisini oluşturur ve değerini True olarak ayarlar. Bu komutu çalıştırmak için PowerShell'i "Yönetici olarak çalıştır" seçeneğiyle başlatın.

İstem için bir iletişim kutusu kullanmak için ConsolePrompting değerini false ($false) olarak ayarlayın veya silmek için Remove-ItemProperty cmdlet'ini kullanın.

ConsolePrompting kayıt defteri girdisi, PowerShell konsolu gibi bazı konak programlarında çalışır. Tüm konak programlarında çalışmayabilir.

Örnek 5

Bu örnekte, Get-Credentialtarafından döndürülenle aynı bir kimlik bilgisi nesnesinin nasıl oluşturulacağı gösterilmektedir.

$User = "Domain01\User01"
$PWord = Read-Host -Prompt 'Enter a Password' -AsSecureString
$credentialParams = @{
    TypeName = 'System.Management.Automation.PSCredential'
    ArgumentList = $User, $PWord
}
$Credential = New-Object @credentialParams

İlk komut kullanıcı adını $User değişkenine atar. Değerin "Domain\User" veya "ComputerName\User" biçimine uydığından emin olun.

İkinci komut, kullanıcı girişinden güvenli bir dize oluşturmak için Read-Host cmdlet'ini kullanır. İstemi parametresi kullanıcı girişini ister ve AsSecureString parametresi girişi maskeler ve güvenli bir dizeye dönüştürür.

Üçüncü komut, New-Object ve değişkenlerinde depolanan değerlerden bir $User nesnesi oluşturmak için $PWord cmdlet'ini kullanır.

Örnek 6

$credentialParams = @{
    Message = "Credential are required for access to the \\Server1\Scripts file share."
    UserName = "Server01\PowerUser"
}
Get-Credential @credentialParams

PowerShell Credential Request
Credential are required for access to the \\Server1\Scripts file share.
Password for user Server01\PowerUser:

Bu komut, cmdlet'in İleti ve Get-Credential parametrelerini kullanır. Bu komut biçimi paylaşılan betikler ve işlevler için tasarlanmıştır. Bu durumda, ileti kullanıcıya kimlik bilgilerinin neden gerekli olduğunu bildirir ve isteğin geçerli olduğuna güven verir.

Örnek 7

Invoke-Command -ComputerName Server01 -ScriptBlock {Get-Credential Domain01\User02}

PowerShell Credential Request : PowerShell Credential Request
Warning: This credential is being requested by a script or application on the SERVER01 remote
computer. Enter your credentials only if you trust the remote computer and the application or script
requesting it.

Enter your credentials.
Password for user Domain01\User02: ***************

PSComputerName     : Server01
RunspaceId         : 422bdf52-9886-4ada-ab2f-130497c6777f
PSShowComputerName : True
UserName           : Domain01\User01
Password           : System.Security.SecureString

Bu komut, Server01 uzak bilgisayarından bir kimlik bilgisi alır. komut, uzak bilgisayarda bir Invoke-Command komutu çalıştırmak için Get-Credential cmdlet'ini kullanır. Çıktı, Get-Credential'ın kimlik doğrulama istemine dahil edilen uzak güvenlik mesajını gösterir.

Parametreler

-Credential

User01 veya Domain01\User01gibi kimlik bilgileri için bir kullanıcı adı belirtir. -Credentialparametre adı isteğe bağlıdır.

Komutu gönderip bir kullanıcı adı belirttiğinizde parola girmeniz istenir. Bu parametreyi atlarsanız kullanıcı adı ve parola girmeniz istenir.

PowerShell 3.0'dan itibaren, bir kullanıcı adını etki alanı olmadan girerseniz Get-Credential artık adın önüne ters eğik çizgi eklemez.

Kimlik bilgileri bir PSCredential nesnesinde depolanır ve parola SecureStringolarak depolanır.

Uyarı

SecureString veri koruması hakkında daha fazla bilgi için bkz. SecureString ne kadar güvenli?.

Parametre özellikleri

Tür:	PSCredential
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

CredentialSet

Position:	1
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Message

Kimlik doğrulama isteminde görüntülenen bir iletiyi belirtir. Bu parametre bir işlevde veya betikte kullanılmak üzere tasarlanmıştır. Kullanıcıya neden kimlik bilgileri istediğinizi ve bunların nasıl kullanılacağını açıklamak için iletiyi kullanabilirsiniz.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

MessageSet

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-UserName

Bir kullanıcı adı belirtir. Kimlik doğrulama istemi, kullanıcı adı için bir parola ister. Varsayılan olarak, kullanıcı adı boş olur ve kimlik doğrulama istemi hem kullanıcı adı hem de parola ister.

Bir iletişim kutusunda kimlik doğrulama istemi görüntülendiğinde, kullanıcı belirtilen kullanıcı adını düzenleyebilir. Ancak komut satırında istem görüntülendiğinde kullanıcı adını değiştiremez. Bu parametreyi paylaşılan bir işlevde veya betikte kullanırken tüm olası sunuları göz önünde bulundurun.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	String
Default value:	None (blank)
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

MessageSet

Position:	1
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

PSCredential

Bu cmdlet bir kimlik bilgisi nesnesi döndürür.

Notlar

Get-Credential parametresine sahip olanlar gibi kullanıcı kimlik doğrulaması isteyen cmdlet'lerde oluşturduğu PSCredential nesnesini kullanabilirsiniz.

Varsayılan olarak, kimlik doğrulama istemi bir iletişim kutusunda görüntülenir. Komut satırında kimlik doğrulama istemini görüntülemek için ConsolePrompting kayıt defteri girdisini (HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\ConsolePrompting) ekleyin ve değerini True olarak ayarlayın. ConsolePrompting kayıt defteri girdisi yoksa veya değeri False ise, kimlik doğrulama istemi bir iletişim kutusunda görüntülenir. Yönergeler için örneklere bakın.

ConsolePrompting kayıt defteri girdisi PowerShell konsolunda çalışır, ancak tüm konak programlarında çalışmaz.

Örneğin, PowerShell Tümleşik Betik Ortamı'nda (ISE) hiçbir etkisi yoktur. ConsolePrompting kayıt defteri girişinin etkisi hakkında bilgi için konak programının yardım konularına bakın.

Kimlik Bilgisi parametresi, PowerShell ile yüklenen tüm sağlayıcılar tarafından desteklenmez. PowerShell 3.0'dan başlayarak, Get-Content ve New-PSDrive cmdlet'leri gibi belirli cmdlet'lerde desteklenir.

İlişkili Bağlantılar

• Kimlik Doğrulama İsteği