Get-NetworkControllerCredential

Get-NetworkControllerCredential

Retrieves a specified device credential or all device credentials from Network Controller.

구문

Parameter Set: Default
Get-NetworkControllerCredential [[-ResourceId] <String[]> ] -ConnectionUri <String> [-CertificateThumbprint <System.String> ] [-Credential <PSCredential> ] [ <CommonParameters>]

자세한 설명

The Get-NetworkControllerCredential retrieves the details of a specified device credential from Network Controller. Network Controller uses this device credential to connect to a southbound device for managing the device.

Get-NetworkControllerCredential retrieves the credential type, and if the credential type is composed of username and password, it retrieves only the user name of the credential.

매개 변수

-CertificateThumbprint<System.String>

Specifies the digital public key X.509 certificate of a user account that has permission to perform this action. This is the certificate thumbprint of the certificate.

This thumbprint must also be provided in the ClientCertificateThumbprint parameter in the Install-NetworkController or Set-NetworkController cmdlet so that Network Controller can authorize this user.

별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-ConnectionUri<String>

Specifies the Uniform Resource Identifier (URI) of the Network Controller, used by all Representational State Transfer (REST) clients to connect to Network Controller.

별칭

none

필수 여부

true

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-Credential<PSCredential>

Specifies a user credential that has permission to perform this action. The default value is the current user.This user must be present in the security group provided in the ClientSecurityGroup parameter in the Install-NetworkController cmdlet.

별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-ResourceId<String[]>

Specifies an array of one or more credentials to retrieve. If ResourceID is not provided, all the credentials in the Network Controller will be retrieved.

별칭

none

필수 여부

false

위치

1

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216)

입력

입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.

출력

출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.

  • The output contains the following fields:
    -- Resource reference uri
    -- Created time of the resource
    -- Instance ID of the resource
    -- Resource Metadata
    -- Resource ID
    -- Properties of the resource

This command retrieves a credential with ID cred1.

PS C:\> Get-NetworkControllerCredential -ConnectionUri "https://restserver" -ResourceId "Cred1"

관련 항목

Install-NetworkController

New-NetworkControllerCredential

Remove-NetworkControllerCredential

Set-NetworkController