Freigeben über

New-AzDataFactoryEncryptValue

  • Referenz
Modul:
Az.DataFactory

Verschlüsselt vertrauliche Daten.

Syntax

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>]

Beschreibung

Das Cmdlet New-AzDataFactoryEncryptValue verschlüsselt vertrauliche Daten, z. B. ein Kennwort oder eine Microsoft SQL Server-Verbindungszeichenfolge, und gibt einen verschlüsselten Wert zurück.

Beispiele

Beispiel 1: Verschlüsseln einer nicht ODBC-Verbindungszeichenfolge

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

Der erste Befehl verwendet das Cmdlet ConvertTo-SecureString, um die angegebene Verbindungszeichenfolge in ein SecureString--Objekt zu konvertieren, und speichert dieses Objekt dann in der $Value Variablen. Geben Sie Get-Help ConvertTo-SecureStringein, um weitere Informationen zu erfahren. Zulässige Werte: SQL Server- oder Oracle-Verbindungszeichenfolge. Der zweite Befehl erstellt einen verschlüsselten Wert für das in $Value gespeicherte Objekt für die angegebene Datenfactory, das Gateway, die Ressourcengruppe und den verknüpften Diensttyp.

Beispiel 2: Verschlüsseln einer nicht ODBC-Verbindungszeichenfolge, die die Windows-Authentifizierung verwendet.

$Value = ConvertTo-SecureString -String '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

Der erste Befehl verwendet ConvertTo-SecureString-, um die angegebene Verbindungszeichenfolge in ein sicheres Zeichenfolgenobjekt zu konvertieren, und speichert dieses Objekt dann in der $Value Variablen. Der zweite Befehl verwendet das Cmdlet Get-Credential, um die Windows-Authentifizierung (Benutzername und Kennwort) zu sammeln, und speichert dann dieses PSCredential--Objekt in der $Credential Variablen. Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren. Der dritte Befehl erstellt einen verschlüsselten Wert für das in $Value gespeicherte Objekt und $Credential für die angegebene Datenfactory, das Gateway, die Ressourcengruppe und den verknüpften Diensttyp.

Beispiel 3: Verschlüsseln des Servernamens und der Anmeldeinformationen für den verknüpften Dateisystemdienst

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

Der erste Befehl verwendet ConvertTo-SecureString-, um die angegebene Zeichenfolge in eine sichere Zeichenfolge zu konvertieren, und speichert dieses Objekt dann in der $Value Variablen. Der zweite Befehl verwendet Get-Credential, um die Windows-Authentifizierung (Benutzername und Kennwort) zu sammeln, und speichert dann das PSCredential--Objekt in der $Credential Variablen. Der dritte Befehl erstellt einen verschlüsselten Wert für das in $Value gespeicherte Objekt und $Credential für die angegebene Datenfactory, das Gateway, die Ressourcengruppe und den verknüpften Diensttyp.

Beispiel 4: Verschlüsseln von Anmeldeinformationen für den verknüpften HDFS-Dienst

$UserName = ConvertTo-SecureString "******" -AsPlainText -Force
$Password = ConvertTo-SecureString "******" -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"

Der Befehl ConvertTo-SecureString konvertiert die angegebene Zeichenfolge in eine sichere Zeichenfolge. Der Befehl New-Object erstellt ein PSCredential-Objekt mithilfe der sicheren Benutzernamen- und Kennwortzeichenfolgen. Stattdessen können Sie den Befehl Get-Credential verwenden, um die Windows-Authentifizierung (Benutzername und Kennwort) zu sammeln, und dann das zurückgegebene PSCredential--Objekt in der $credential Variablen speichern, wie in den vorherigen Beispielen gezeigt. Der Befehl New-AzDataFactoryEncryptValue erstellt einen verschlüsselten Wert für das objekt, das in $Credential für die angegebene Datenfactory, das Gateway, die Ressourcengruppe und den verknüpften Diensttyp gespeichert ist.

Beispiel 5: Verschlüsseln von Anmeldeinformationen für odbc-verknüpften Dienst

$Content = ConvertTo-SecureString "UID=username@contoso;PWD=******;" -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

Der Befehl ConvertTo-SecureString konvertiert die angegebene Zeichenfolge in eine sichere Zeichenfolge. Der Befehl New-AzDataFactoryEncryptValue erstellt einen verschlüsselten Wert für das objekt, das in $Value für die angegebene Datenfactory, das Gateway, die Ressourcengruppe und den verknüpften Diensttyp gespeichert ist.

Parameter

-AuthenticationType

Gibt den Typ der Authentifizierung an, die zum Herstellen einer Verbindung mit der Datenquelle verwendet werden soll. Die zulässigen Werte für diesen Parameter sind:

  • Fenster
  • Grundlegend
  • Anonym.
Typ:String
Zulässige Werte:Windows, Basic, Anonymous
Position:6
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt die windows-Authentifizierungsanmeldeinformationen (Benutzername und Kennwort) an, die verwendet werden sollen. Dieses Cmdlet verschlüsselt die hier angegebenen Anmeldeinformationsdaten.

Typ:PSCredential
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Database

Gibt den Datenbanknamen des verknüpften Diensts an.

Typ:String
Position:8
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DataFactory

Gibt ein PSDataFactory- -Objekt an. Dieses Cmdlet verschlüsselt Daten für die Datenfactory, die dieser Parameter angibt.

Typ:PSDataFactory
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DataFactoryName

Gibt den Namen einer Datenfactory an. Dieses Cmdlet verschlüsselt Daten für die Datenfactory, die dieser Parameter angibt.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GatewayName

Gibt den Namen des Gateways an. Dieses Cmdlet verschlüsselt Daten für das Gateway, das dieser Parameter angibt.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NonCredentialValue

Gibt den Nicht-Anmeldeinformationsteil der ODBC-Verbindungszeichenfolge (Open Database Connectivity) an. Dieser Parameter gilt nur für den ODBC-verknüpften Dienst.

Typ:String
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt den Namen einer Azure-Ressourcengruppe an. Dieses Cmdlet verschlüsselt Daten für die Gruppe, die dieser Parameter angibt.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Server

Gibt den Servernamen des verknüpften Diensts an.

Typ:String
Position:7
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Type

Gibt den verknüpften Diensttyp an. Dieses Cmdlet verschlüsselt Daten für den verknüpften Diensttyp, den dieser Parameter angibt. Die zulässigen Werte für diesen Parameter sind:

  • OnPremisesSqlLinkedService
  • OnPremisesFileSystemLinkedService
  • OnPremisesOracleLinkedService
  • OnPremisesOdbcLinkedService
  • OnPremisesPostgreSqlLinkedService
  • OnPremisesTeradataLinkedService
  • OnPremisesMySQLLinkedService
  • OnPremisesDB2LinkedService
  • OnPremisesSybaseLinkedService
Typ:String
Zulässige Werte:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Value

Gibt den zu verschlüsselnden Wert an. Verwenden Sie für einen lokalen sql Server-verknüpften Dienst und einen lokalen Oracle-verknüpften Dienst eine Verbindungszeichenfolge. Verwenden Sie für einen lokalen ODBC-verknüpften Dienst den Anmeldeinformationsteil der Verbindungszeichenfolge. Wenn das Dateisystem lokal auf dem Gatewaycomputer lokal ist, verwenden Sie "Local" oder "localhost", und wenn sich das Dateisystem auf einem Server befindet, der sich vom Gatewaycomputer unterscheidet, verwenden Sie "\\servername".

Typ:SecureString
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSDataFactory

String

Ausgaben

String

Hinweise

  • Schlüsselwörter: azure, azurerm, arm, resource, management, manager, data, factories