< Back

New-AzureRmDataLakeAnalyticsCatalogCredential

Tue Jan 29, 2019 9:43 pm

NAME New-AzureRmDataLakeAnalyticsCatalogCredential



SYNOPSIS

Creates a new Azure Data Lake Analytics catalog credential.





SYNTAX

New-AzureRmDataLakeAnalyticsCatalogCredential [-Account] <String> [-DatabaseName] <String> [-CredentialName] <String> [-Credential] <PSCredential>

[-DatabaseHost] <String> [-Port] <Int32> [-DefaultProfile <IAzureContextContainer>] [-Confirm] [-WhatIf] [<CommonParameters>]



New-AzureRmDataLakeAnalyticsCatalogCredential [-Account] <String> [-DatabaseName] <String> [-CredentialName] <String> [-Credential] <PSCredential>

[-Uri] <Uri> [-DefaultProfile <IAzureContextContainer>] [-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

The New-AzureRmDataLakeAnalyticsCatalogCredential cmdlet creates a new credential to use in an Azure Data Lake Analytics catalog for connecting to

external data sources.





PARAMETERS

-Account <String>

Specifies the Data Lake Analytics account name.



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Credential <PSCredential>

Specifies the user name and corresponding password of the credential.



Required? true

Position? 3

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-CredentialName <String>

Specifies the name and password of the credential.



Required? true

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-DatabaseHost <String>

Specifies the host name of the external data source the credential can connect to in the format mydatabase.contoso.com.



Required? true

Position? 4

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-DatabaseName <String>

Specifies the name of the database in the Data Lake Analytics acocunt that the credential will be stored in.



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with azure



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Port <Int32>

Specifies the port number used to connect to the specified DatabaseHost using this credential.



Required? true

Position? 5

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Uri <Uri>

Specifies the full Uniform Resource Identifier (URI) of the external data source this credential can connect to.



Required? true

Position? 4

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]





Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None

This cmdlet does not accept any input.





OUTPUTS

None







NOTES









Example 1: Create a credential for a catalog specifying host and port



PS C:\\> New-AzureRmDataLakeAnalyticsCatalogCredential -AccountName "ContosoAdlAccount" `

-DatabaseName "databaseName" `

-CredentialName "exampleDbCred" `

-Credential (Get-Credential) `

-DatabaseHost "example.contoso.com" -Port 8080



This command creates the specified credential for the specified account, database, host and port using https protocol.





Example 2: Create a credential for a catalog specifying full URI



PS C:\\> New-AzureRmDataLakeAnalyticsCatalogCredential -AccountName "ContosoAdlAccount" `

-DatabaseName "databaseName" `

-CredentialName "exampleDbCred" `

-Credential (Get-Credential) `

-Uri "http://httpExample.contoso.com:8080"



This command creates the specified credential for the specified account, database and external data source URI.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... credential