Bagikan melalui

New-AzDataFactoryEncryptValue

  • Referensi
Modul:
Az.DataFactory

Mengenkripsi data sensitif.

Sintaks

New-AzDataFactoryEncryptValue
   [-DataFactoryName] <String>
   [[-Value] <SecureString>]
   [-GatewayName] <String>
   [[-Credential] <PSCredential>]
   [[-Type] <String>]
   [[-NonCredentialValue] <String>]
   [[-AuthenticationType] <String>]
   [[-Server] <String>]
   [[-Database] <String>]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDataFactoryEncryptValue
   [-DataFactory] <PSDataFactory>
   [[-Value] <SecureString>]
   [-GatewayName] <String>
   [[-Credential] <PSCredential>]
   [[-Type] <String>]
   [[-NonCredentialValue] <String>]
   [[-AuthenticationType] <String>]
   [[-Server] <String>]
   [[-Database] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Deskripsi

Cmdlet New-AzDataFactoryEncryptValue mengenkripsi data sensitif, seperti kata sandi atau string koneksi Microsoft SQL Server, dan mengembalikan nilai terenkripsi.

Contoh

Contoh 1: Mengenkripsi string koneksi non-ODBC

$Value = ConvertTo-SecureString 'Data Source=ContosoServer;Initial Catalog=catalog;user id =user123;password=password123' -AsPlainText -Force 
New-AzDataFactoryEncryptValue -GatewayName "WikiGateway" -DataFactoryName "WikiAdf" -Value $value -ResourceGroupName "ADF" -Type OnPremisesSqlLinkedService

Perintah pertama menggunakan cmdlet ConvertTo-SecureString untuk mengonversi string koneksi yang ditentukan menjadi objek SecureString, lalu menyimpan objek tersebut dalam variabel $Value. Untuk informasi selengkapnya, ketik Get-Help ConvertTo-SecureString. Nilai yang diizinkan: SQL Server atau Oracle string koneksi. Perintah kedua membuat nilai terenkripsi untuk objek yang disimpan di $Value untuk pabrik data, gateway, grup sumber daya, dan jenis layanan tertaut yang ditentukan.

Contoh 2: Mengenkripsi string koneksi non-ODBC yang menggunakan autentikasi Windows.

$Value = ConvertTo-SecureString 'Data Source=ContosoServer;Initial Catalog=catalog;Integrated Security=True' -AsPlainText -Force
$Credential = Get-Credential
New-AzDataFactoryEncryptValue -DataFactoryName "WikiADF" -GatewayName "WikiGateway" -ResourceGroupName "ADF" -Value $Value -Credential $Credential -Type OnPremisesSqlLinkedService

Perintah pertama menggunakan ConvertTo-SecureString untuk mengonversi string koneksi yang ditentukan menjadi objek string aman, lalu menyimpan objek tersebut dalam variabel $Value. Perintah kedua menggunakan cmdlet Get-Credential untuk mengumpulkan autentikasi windows (nama pengguna dan kata sandi), lalu menyimpan objek PSCredential tersebut dalam variabel $Credential. Untuk informasi selengkapnya, ketik Get-Help Get-Credential. Perintah ketiga membuat nilai terenkripsi untuk objek yang disimpan di $Value dan $Credential untuk pabrik data, gateway, grup sumber daya, dan jenis layanan tertaut yang ditentukan.

Contoh 3: Mengenkripsi nama server dan kredensial untuk layanan tertaut sistem file

$Value = ConvertTo-SecureString '\\servername' -AsPlainText -Force
$Credential = Get-Credential
New-AzDataFactoryEncryptValue -DataFactoryName "WikiADF" -GatewayName "WikiGateway" -ResourceGroupName "ADF" -Value $Value -Credential $Credential -Type OnPremisesFileSystemLinkedService

Perintah pertama menggunakan ConvertTo-SecureString untuk mengonversi string yang ditentukan menjadi string aman, lalu menyimpan objek tersebut dalam variabel $Value. Perintah kedua menggunakan Get-Credential untuk mengumpulkan autentikasi Windows (nama pengguna dan kata sandi), lalu menyimpan objek PSCredential tersebut dalam variabel $Credential. Perintah ketiga membuat nilai terenkripsi untuk objek yang disimpan di $Value dan $Credential untuk pabrik data, gateway, grup sumber daya, dan jenis layanan tertaut yang ditentukan.

Contoh 4: Mengenkripsi kredensial untuk layanan tertaut HDFS

$UserName = ConvertTo-SecureString "domain\\username" -AsPlainText -Force
$Password = ConvertTo-SecureString "password" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ($UserName, $Password)
New-AzDataFactoryEncryptValue -DataFactoryName "MyDataFactory" -ResourceGroupName "MyResourceGroup" -GatewayName "MyDataManagementGateway" -Type HdfsLinkedService -AuthenticationType Windows -Credential $Credential -NonCredentialValue "http://server01.com:50070/webhdfs/v1/user/username"

Perintah ConvertTo-SecureString mengonversi string yang ditentukan menjadi string aman. Perintah New-Object membuat objek PSCredential menggunakan string nama pengguna dan kata sandi yang aman. Sebagai gantinya, Anda dapat menggunakan perintah Get-Credential untuk mengumpulkan autentikasi Windows (nama pengguna dan kata sandi), lalu menyimpan objek PSCredential yang dikembalikan dalam variabel $credential seperti yang ditunjukkan pada contoh sebelumnya. Perintah New-AzDataFactoryEncryptValue membuat nilai terenkripsi untuk objek yang disimpan di $Credential untuk pabrik data, gateway, grup sumber daya, dan jenis layanan tertaut yang ditentukan.

Contoh 5: Mengenkripsi kredensial untuk layanan tertaut ODBC

$Content = ConvertTo-SecureString "UID=username@contoso;PWD=password;" -AsPlainText -Force
New-AzDataFactoryEncryptValue -ResourceGroupName $RGName -DataFactoryName $DFName -GatewayName $Gateway -Type OnPremisesOdbcLinkedService -AuthenticationType Basic -NonCredentialValue "Driver={SQL Server};Server=server01.database.contoso.net; Database=HDISScenarioTest;" -Value $content

Perintah ConvertTo-SecureString mengonversi string yang ditentukan menjadi string aman. Perintah New-AzDataFactoryEncryptValue membuat nilai terenkripsi untuk objek yang disimpan di $Value untuk pabrik data, gateway, grup sumber daya, dan jenis layanan tertaut yang ditentukan.

Parameter

-AuthenticationType

Menentukan jenis autentikasi yang akan digunakan untuk menyambungkan ke sumber data. Nilai yang dapat diterima untuk parameter ini adalah:

  • Windows
  • Dasar
  • Anonim.
Jenis:String
Nilai yang diterima:Windows, Basic, Anonymous
Position:6
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Credential

Menentukan kredensial autentikasi Windows (nama pengguna dan kata sandi) yang akan digunakan. Cmdlet ini mengenkripsi data kredensial yang Anda tentukan di sini.

Jenis:PSCredential
Position:3
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Database

Menentukan nama database layanan tertaut.

Jenis:String
Position:8
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DataFactory

Menentukan objek PSDataFactory. Cmdlet ini mengenkripsi data untuk pabrik data yang ditentukan parameter ini.

Jenis:PSDataFactory
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-DataFactoryName

Menentukan nama pabrik data. Cmdlet ini mengenkripsi data untuk pabrik data yang ditentukan parameter ini.

Jenis:String
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure

Jenis:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-GatewayName

Menentukan nama gateway. Cmdlet ini mengenkripsi data untuk gateway yang ditentukan parameter ini.

Jenis:String
Position:2
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-NonCredentialValue

Menentukan bagian non-kredensial dari string koneksi Open Database Connectivity (ODBC). Parameter ini hanya berlaku untuk layanan tertaut ODBC.

Jenis:String
Position:5
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ResourceGroupName

Menentukan nama grup sumber daya Azure. Cmdlet ini mengenkripsi data untuk grup yang ditentukan parameter ini.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Server

Menentukan nama server layanan tertaut.

Jenis:String
Position:7
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Type

Menentukan jenis layanan tertaut. Cmdlet ini mengenkripsi data untuk jenis layanan tertaut yang ditentukan parameter ini. Nilai yang dapat diterima untuk parameter ini adalah:

  • OnPremisesSqlLinkedService
  • OnPremisesFileSystemLinkedService
  • OnPremisesOracleLinkedService
  • OnPremisesOdbcLinkedService
  • OnPremisesPostgreSqlLinkedService
  • OnPremisesTeradataLinkedService
  • OnPremisesMySQLLinkedService
  • OnPremisesDB2LinkedService
  • OnPremisesSybaseLinkedService
Jenis:String
Nilai yang diterima:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Position:4
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Value

Menentukan nilai yang akan dienkripsi. Untuk layanan tertaut SQL Server lokal dan layanan tertaut Oracle lokal, gunakan string koneksi. Untuk layanan tertaut ODBC lokal, gunakan bagian kredensial dari string koneksi. Untuk layanan tertaut sistem file lokal, jika sistem file lokal ke komputer gateway, gunakan Lokal atau localhost, dan jika sistem file berada di server yang berbeda dari komputer gateway, gunakan \\servername.

Jenis:SecureString
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

PSDataFactory

String

Output

String

Catatan

  • Kata kunci: azure, azurerm, arm, sumber daya, manajemen, manajer, data, pabrik