Freigeben über

New-AzDataFactoryEncryptValue

Modul:
Az.DataFactory Module

Verschlüsselt vertrauliche Daten.

Syntax

ByFactoryName (Standard) 

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

ByFactoryObject 

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 weitere Informationen ein Get-Help ConvertTo-SecureString. 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 das PSCredential-Objekt in der $Credential Variablen. Geben Sie weitere Informationen ein Get-Help Get-Credential. 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 in $Credential gespeicherte Objekt für die angegebene Datenfactory, das Gateway, die Ressourcengruppe und den verknüpften Diensttyp.

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 in $Value gespeicherte Objekt für die angegebene Datenfactory, das Gateway, die Ressourcengruppe und den verknüpften Diensttyp.

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
  • Basic
  • Anonym.

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:Windows, Basic, Anonymous
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:6
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Credential

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

Parametereigenschaften

Typ:PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:3
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Database

Gibt den Datenbanknamen des verknüpften Diensts an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:8
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DataFactory

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

Parametereigenschaften

Typ:PSDataFactory
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFactoryObject
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DataFactoryName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFactoryName
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-GatewayName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-NonCredentialValue

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:5
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFactoryName
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Server

Gibt den Servernamen des verknüpften Diensts an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:7
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:4
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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".

Parametereigenschaften

Typ:SecureString
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSDataFactory

String

Ausgaben

String

Hinweise

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