Udostępnij przez

New-AzDataFactoryEncryptValue

Moduł:
Az.DataFactory Module

Szyfruje poufne dane.

Składnia

ByFactoryName (domyślnie) 

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

Opis

Polecenie cmdlet New-AzDataFactoryEncryptValue szyfruje poufne dane, takie jak hasło lub parametry połączenia programu Microsoft SQL Server, i zwraca zaszyfrowaną wartość.

Przykłady

Przykład 1: Szyfrowanie parametrów połączenia innych niż ODBC

$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

Pierwsze polecenie używa polecenia cmdlet ConvertTo-SecureString, aby przekonwertować określone parametry połączenia na obiekt SecureString , a następnie przechowuje ten obiekt w zmiennej $Value. Aby uzyskać więcej informacji, wpisz Get-Help ConvertTo-SecureString. Dozwolone wartości: parametry połączenia programu SQL Server lub Oracle. Drugie polecenie tworzy zaszyfrowaną wartość dla obiektu przechowywanego w $Value dla określonej fabryki danych, bramy, grupy zasobów i połączonego typu usługi.

Przykład 2: Szyfrowanie parametrów połączenia innych niż ODBC, które używają uwierzytelniania systemu Windows.

$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

Pierwsze polecenie używa funkcji ConvertTo-SecureString , aby przekonwertować określone parametry połączenia na obiekt parametrów bezpiecznych, a następnie przechowuje ten obiekt w zmiennej $Value. Drugie polecenie używa polecenia cmdlet Get-Credential do zbierania uwierzytelniania systemu Windows (nazwy użytkownika i hasła), a następnie przechowuje ten obiekt PSCredential w zmiennej $Credential. Aby uzyskać więcej informacji, wpisz Get-Help Get-Credential. Trzecie polecenie tworzy zaszyfrowaną wartość dla obiektu przechowywanego w $Value i $Credential dla określonej fabryki danych, bramy, grupy zasobów i połączonego typu usługi.

Przykład 3. Szyfrowanie nazwy serwera i poświadczeń dla połączonej usługi systemu plików

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

Pierwsze polecenie używa funkcji ConvertTo-SecureString , aby przekonwertować określony ciąg na bezpieczny ciąg, a następnie przechowuje ten obiekt w zmiennej $Value. Drugie polecenie używa polecenia Get-Credential do zbierania uwierzytelniania systemu Windows (nazwy użytkownika i hasła), a następnie przechowuje ten obiekt PSCredential w zmiennej $Credential. Trzecie polecenie tworzy zaszyfrowaną wartość dla obiektu przechowywanego w $Value i $Credential dla określonej fabryki danych, bramy, grupy zasobów i połączonego typu usługi.

Przykład 4. Szyfrowanie poświadczeń dla połączonej usługi HDFS

$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"

Polecenie ConvertTo-SecureString konwertuje określony ciąg na bezpieczny ciąg. Polecenie New-Object tworzy obiekt PSCredential przy użyciu bezpiecznych ciągów nazwy użytkownika i hasła. Zamiast tego możesz użyć polecenia Get-Credential , aby zebrać uwierzytelnianie systemu Windows (nazwę użytkownika i hasło), a następnie zapisać zwrócony obiekt PSCredential w zmiennej $credential, jak pokazano w poprzednich przykładach. Polecenie New-AzDataFactoryEncryptValue tworzy zaszyfrowaną wartość dla obiektu przechowywanego w $Credential dla określonej fabryki danych, bramy, grupy zasobów i połączonego typu usługi.

Przykład 5. Szyfrowanie poświadczeń dla połączonej usługi ODBC

$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

Polecenie ConvertTo-SecureString konwertuje określony ciąg na bezpieczny ciąg. Polecenie New-AzDataFactoryEncryptValue tworzy zaszyfrowaną wartość dla obiektu przechowywanego w $Value dla określonej fabryki danych, bramy, grupy zasobów i połączonego typu usługi.

Parametry

-AuthenticationType

Określa typ uwierzytelniania, który ma być używany do nawiązywania połączenia ze źródłem danych. Dopuszczalne wartości tego parametru to:

  • Windows
  • Basic
  • Anonimowy.

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:Windows, Basic, Anonymous
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:6
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Credential

Określa poświadczenia uwierzytelniania systemu Windows (nazwa użytkownika i hasło), które mają być używane. To polecenie cmdlet szyfruje dane poświadczeń określone w tym miejscu.

Właściwości parametru

Typ:PSCredential
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:3
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Database

Określa nazwę bazy danych połączonej usługi.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:8
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DataFactory

Określa obiekt PSDataFactory . To polecenie cmdlet szyfruje dane dla fabryki danych, którą określa ten parametr.

Właściwości parametru

Typ:PSDataFactory
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ByFactoryObject
Position:0
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-DataFactoryName

Określa nazwę fabryki danych. To polecenie cmdlet szyfruje dane dla fabryki danych, którą określa ten parametr.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ByFactoryName
Position:1
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-GatewayName

Określa nazwę bramy. To polecenie cmdlet szyfruje dane dla bramy, którą określa ten parametr.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:2
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-NonCredentialValue

Określa część połączenia bez poświadczeń parametrów połączenia Open Database Connectivity (ODBC). Ten parametr ma zastosowanie tylko dla połączonej usługi ODBC.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:5
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResourceGroupName

Określa nazwę grupy zasobów platformy Azure. To polecenie cmdlet szyfruje dane dla grupy, którą określa ten parametr.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ByFactoryName
Position:0
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Server

Określa nazwę serwera połączonej usługi.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:7
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Type

Określa typ połączonej usługi. To polecenie cmdlet szyfruje dane dla połączonego typu usługi, który określa ten parametr. Dopuszczalne wartości tego parametru to:

  • OnPremisesSqlLinkedService
  • OnPremisesFileSystemLinkedService
  • OnPremisesOracleLinkedService
  • OnPremisesOdbcLinkedService
  • OnPremisesPostgreSqlLinkedService
  • OnPremisesTeradataLinkedService
  • OnPremisesMySQLLinkedService
  • OnPremisesDB2LinkedService
  • OnPremisesSybaseLinkedService

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:4
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Value

Określa wartość do zaszyfrowania. W przypadku lokalnej połączonej usługi SQL Server i lokalnej połączonej usługi Oracle użyj parametrów połączenia. W przypadku lokalnej połączonej usługi ODBC użyj części poświadczeń parametrów połączenia. W przypadku lokalnej połączonej usługi systemu plików, jeśli system plików jest lokalny na komputerze bramy, użyj lokalnego lub localhostu, a jeśli system plików znajduje się na serwerze innym niż komputer bramy, użyj \\servername.

Właściwości parametru

Typ:SecureString
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:1
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

PSDataFactory

String

Dane wyjściowe

String

Uwagi

  • Słowa kluczowe: azure, azurerm, arm, resource, management, manager, data, factory