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 ein Microsoft-SQL Server Verbindungszeichenfolge, und gibt einen verschlüsselten Wert zurück.

Beispiele

Beispiel 1: Verschlüsseln eines 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 dieses Objekt dann in der $Value Variablen zu speichern. Geben Sie weitere Informationen ein . 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 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 . 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 diese 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 Windows-Authentifizierung (Benutzername und Kennwort) zu sammeln und dann die zurückgegebenen PSCredentialObjekt in der variablen $credential zu 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:

  • Windows
  • Basisversion
  • 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-Authentifizierung Anmeldeinformationen (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 einen Verbindungszeichenfolge. Verwenden Sie für einen lokalen ODBC-verknüpften Dienst den Anmeldeinformationsteil des 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