Add-SqlLogin

Modul:

SqlServer Module

Membuat objek Login dalam instans SQL Server.

Sintaks

ByPath (Default)

Add-SqlLogin
    [[-Path] <String>]
    -LoginType <LoginType>
    [-LoginName <String>]
    [-DefaultDatabase <String>]
    [-EnforcePasswordPolicy]
    [-EnforcePasswordExpiration]
    [-MustChangePasswordAtNextLogin]
    [-Certificate <String>]
    [-AsymmetricKey <String>]
    [-CredentialName <String>]
    [-LoginPSCredential <PSCredential>]
    [-Enable]
    [-GrantConnectSql]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [<CommonParameters>]

ByObject

Add-SqlLogin
    [[-InputObject] <Server>]
    -LoginType <LoginType>
    [-LoginName <String>]
    [-DefaultDatabase <String>]
    [-EnforcePasswordPolicy]
    [-EnforcePasswordExpiration]
    [-MustChangePasswordAtNextLogin]
    [-Certificate <String>]
    [-AsymmetricKey <String>]
    [-CredentialName <String>]
    [-LoginPSCredential <PSCredential>]
    [-Enable]
    [-GrantConnectSql]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [<CommonParameters>]

ByName

Add-SqlLogin
    [[-ServerInstance] <String[]>]
    -LoginType <LoginType>
    [-LoginName <String>]
    [-DefaultDatabase <String>]
    [-EnforcePasswordPolicy]
    [-EnforcePasswordExpiration]
    [-MustChangePasswordAtNextLogin]
    [-Certificate <String>]
    [-AsymmetricKey <String>]
    [-CredentialName <String>]
    [-LoginPSCredential <PSCredential>]
    [-Enable]
    [-GrantConnectSql]
    [-Credential <PSCredential>]
    [-ConnectionTimeout <Int32>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [<CommonParameters>]

Deskripsi

Cmdlet Add-SqlLogin membuat objek Login dalam instans SQL Server.

Contoh

Contoh 1: Membuat jenis SqlLogin

PS C:\> Add-SqlLogin -ServerInstance "MyServerInstance" -LoginName "MyLogin" -LoginType "SqlLogin" -DefaultDatabase "OtherDatabase"

Name                                          Login Type    Created
----                                          ----------    -------
MyLogin                                       SqlLogin      8/11/2016 3:19 PM

Perintah ini membuat objek Login yang diberi nama 'MyLogin' dari jenis SqlLogin. Perintah menentukan database defaultnya sebagai 'OtherDatabase' dalam instans server bernama 'MyServerInstance'. Perintah ini meminta kata sandi untuk Login.

Contoh 2: Membuat jenis kunci asimetris

PS C:\> Add-SqlLogin -ServerInstance "MyServerInstance" -LoginName "MyLogin" -LoginType "AsymmetricKey" -AsymmetricKey "MyKey" -CredentialName "MyCredential"

Name                                          Login Type    Created
----                                          ----------    -------
MyLogin                                       AsymmetricKey 8/11/2016 4:08 PM

Perintah ini membuat objek Login yang diberi nama MyLogin dari jenis AsymmetricKey. Ini menentukan kunci asimetris yang bernama MyKey. Juga memetakan kredensial yang disebut MyCredential ke objek Login baru. Perintah beroperasi di instans server bernama MyServerInstance.

Parameter

-AccessToken

Token akses yang digunakan untuk mengautentikasi ke SQL Server, sebagai alternatif untuk pengguna/kata sandi atau Autentikasi Windows.

Ini dapat digunakan, misalnya, untuk menyambungkan ke SQL Azure DB dan SQL Azure Managed Instance menggunakan Service Principal atau Managed Identity.

Parameter yang digunakan dapat berupa string yang mewakili token atau objek seperti yang PSAccessToken dikembalikan dengan menjalankan Get-AzAccessToken -ResourceUrl https://database.windows.net.

Parameter ini baru dalam v22 modul.

Properti parameter

Jenis:	PSObject
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-AsymmetricKey

Tentukan nama kunci asimetris untuk objek Masuk. Jika parameter LoginType memiliki nilai AsymmetricKey, tentukan kunci asimetris.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Certificate

Tentukan nama sertifikat untuk objek Masuk. Jika LoginType memiliki nilai Sertifikat, tentukan sertifikat.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ConnectionTimeout

Menentukan jumlah detik untuk menunggu koneksi server sebelum kegagalan waktu habis. Nilai waktu habis harus berupa bilangan bulat antara 0 dan 65534. Jika 0 ditentukan, upaya koneksi tidak kehabisan waktu.

Properti parameter

Jenis:	Int32
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Credential

Menentukan objek PSCredential untuk koneksi ke SQL Server. Untuk mendapatkan objek kredensial, gunakan cmdlet Get-Credential. Untuk informasi selengkapnya, ketik Get-Help Get-Credential.

Properti parameter

Jenis:	PSCredential
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CredentialName

Tentukan nama kredensial untuk objek Masuk.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-DefaultDatabase

Tentukan database default untuk objek Masuk. Nilai defaultnya adalah master.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Enable

Menunjukkan bahwa objek Masuk diaktifkan. Secara default, objek Masuk dinonaktifkan.

Objek tipe WindowsGroup selalu diaktifkan. Parameter ini tidak memengaruhinya.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Encrypt

Jenis enkripsi yang akan digunakan saat menyambungkan ke SQL Server.

Nilai ini memetakan ke Encrypt properti SqlConnectionEncryptOption pada objek SqlConnection dari driver Microsoft.Data.SqlClient.

Dalam v22 modul, defaultnya adalah Optional (untuk kompatibilitas dengan v21). Dalam v23+ modul, nilai defaultnya adalah 'Wajib', yang dapat membuat perubahan yang melanggar untuk skrip yang ada.

Parameter ini baru dalam v22 modul.

Properti parameter

Jenis:	String
Nilai default:	None
Nilai yang diterima:	Mandatory, Optional, Strict
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-EnforcePasswordExpiration

Menunjukkan bahwa kebijakan kedaluwarsa kata sandi diberlakukan untuk objek Masuk. Parameter ini hanya menerapkan objek jenis SqlLogin. Parameter ini menyiratkan parameter EnforcePasswordPolicy. Anda tidak perlu menentukan keduanya.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-EnforcePasswordPolicy

Menunjukkan bahwa kebijakan kata sandi diberlakukan untuk objek Masuk. Parameter ini hanya menerapkan objek jenis SqlLogin.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-GrantConnectSql

Menunjukkan bahwa objek Masuk tidak ditolak izin untuk menyambungkan ke mesin database. Secara default, Objek login ditolak izin untuk tersambung ke mesin database, kecuali server target adalah SQL Azure.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-HostNameInCertificate

Nama host yang akan digunakan dalam memvalidasi sertifikat SQL Server TLS/SSL. Anda harus meneruskan parameter ini jika instans SQL Server Anda diaktifkan untuk Enkripsi Paksa dan Anda ingin terhubung ke instans menggunakan nama host/nama pendek. Jika parameter ini dihilangkan, maka meneruskan Nama Domain yang Sepenuhnya Memenuhi Syarat (FQDN) ke -ServerInstance diperlukan untuk terhubung ke instans SQL Server yang diaktifkan untuk Enkripsi Paksa.

Parameter ini baru dalam v22 modul.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-InputObject

Menentukan objek SQL Server Management Objects (SMO) tempat cmdlet ini beroperasi.

Properti parameter

Jenis:	Server
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByObject

Position:	1
Wajib:	False
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-LoginName

Menentukan nama untuk objek Masuk. Sensitivitas kasus sama dengan instans SQL Server.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Nama

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-LoginPSCredential

Menentukan objek PSCredential yang memungkinkan objek Masuk untuk memberikan nama dan kata sandi tanpa perintah.

Properti parameter

Jenis:	PSCredential
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-LoginType

Menentukan jenis objek Masuk sebagai nilai Microsoft.SqlServer.Management.Smo.LoginType. Nilai yang dapat diterima untuk parameter ini adalah:

• AsymmetricKey
• Sertifikat
• SqlLogin
• WindowsGroup
• WindowsUser

Saat ini, cmdlet tidak mendukung ExternalUser atau ExternalGroup.

Properti parameter

Jenis:	LoginType
Nilai default:	None
Nilai yang diterima:	WindowsUser, WindowsGroup, SqlLogin, Certificate, AsymmetricKey, ExternalUser, ExternalGroup
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-MustChangePasswordAtNextLogin

Menunjukkan bahwa pengguna harus mengubah kata sandi pada login berikutnya. Parameter ini hanya menerapkan objek jenis SqlLogin. Parameter ini menyiratkan parameter EnforcePasswordExpiration. Anda tidak perlu menentukan keduanya.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Path

Menentukan jalur SQL Server tempat cmdlet ini menjalankan operasi. Nilai default adalah direktori kerja saat ini.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByPath

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Script

Menunjukkan bahwa cmdlet ini mengembalikan skrip Transact-SQL yang melakukan tugas yang dilakukan cmdlet ini.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ServerInstance

Menentukan nama instans SQL Server. Untuk instans default, tentukan nama komputer. Untuk instans bernama, gunakan format ComputerName\InstanceName.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

ByName

Position:	1
Wajib:	False
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-TrustServerCertificate

Menunjukkan apakah saluran akan dienkripsi saat melewati rantai sertifikat untuk memvalidasi kepercayaan.

Dalam v22 modul, defaultnya adalah $true (untuk kompatibilitas dengan v21). Dalam v23+ modul, nilai defaultnya adalah '$false', yang dapat membuat perubahan yang melanggar untuk skrip yang ada.

Parameter ini baru dalam v22 modul.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

Microsoft.SqlServer.Management.Smo.Server

System.String[]

Output

System.Object

Link Terkait

• Get-SqlLogin
• Remove-SqlLogin