Connect-SecMgmtAccount

Moduł:

SecMgmt Module

Połącz się z chmurą firmy Microsoft przy użyciu uwierzytelnionego konta do użycia z poleceniami cmdlet.

Składnia

User (Domyślna)

Connect-SecMgmtAccount
    [-Environment <EnvironmentName>]
    [-Tenant <String>]
    [-UseDeviceAuthentication]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AccessToken

Connect-SecMgmtAccount
    -AccessToken <String>
    [-Environment <EnvironmentName>]
    [-Tenant <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RefreshToken

Connect-SecMgmtAccount
    -ApplicationId <String>
    -RefreshToken <String>
    [-CertificateThumbprint <String>]
    [-Credential <PSCredential>]
    [-Environment <EnvironmentName>]
    [-Tenant <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ServicePrincipalCertificate

Connect-SecMgmtAccount
    -ApplicationId <String>
    -CertificateThumbprint <String>
    -Tenant <String>
    [-Environment <EnvironmentName>]
    [-ServicePrincipal]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ServicePrincipal

Connect-SecMgmtAccount
    -Credential <PSCredential>
    -Tenant <String>
    [-Environment <EnvironmentName>]
    [-ServicePrincipal]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Połącz się z chmurą firmy Microsoft przy użyciu uwierzytelnionego konta do użycia z poleceniami cmdlet.

Przykłady

Przykład 1

PS C:\> Connect-SecMgmtAccount

To polecenie łączy się z chmurą firmy Microsoft.

Przykład 2

PS C:\> $credential = Get-Credential
PS C:\> Connect-SecMgmtAccount -Credential $credential -Tenant 'xxxx-xxxx-xxxx-xxxx' -ServicePrincipal

Pierwsze polecenie pobiera poświadczenia jednostki usługi (identyfikator aplikacji i klucz tajny jednostki usługi), a następnie zapisuje je w zmiennej $credential. Drugie polecenie łączy się z chmurą firmy Microsoft przy użyciu poświadczeń jednostki usługi przechowywanych w $credential dla określonej dzierżawy. Parametr przełącznika ServicePrincipal wskazuje, że konto uwierzytelnia się jako jednostka usługi.

Przykład 3

PS C:\> $refreshToken = '<refreshToken>'
PS C:\> Connect-SecMgmtAccount -ApplicationId 'xxxx-xxxx-xxxx-xxxx' -RefreshToken $refreshToken

Łączy się z chmurą firmy Microsoft przy użyciu tokenu odświeżania, który został wygenerowany przy użyciu aplikacji natywnej.

Przykład 4

PS C:\> $appId = 'xxxx-xxxx-xxxx-xxxx'
PS C:\> $secret =  ConvertTo-SecureString 'app-secret-here' -AsPlainText -Force
PS C:\> $refreshToken = '<refreshToken>'
PC C:\> $tenantId = 'yyyy-yyyy-yyyy-yyyy'
PS C:\>
PS C:\> $credential = New-Object System.Management.Automation.PSCredential($appId, $secret)
PS C:\>
PS C:\> Connect-SecMgmtAccount -ApplicationId $appId -Credential $credential -RefreshToken $refreshToken

Łączy się z chmurą firmy Microsoft przy użyciu tokenu odświeżania, który został wygenerowany przy użyciu aplikacji internetowej.

Parametry

-AccessToken

Token dostępu używany do nawiązywania połączenia.

Właściwości parametru

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

Zestawy parametrów

AccessToken

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

-ApplicationId

Identyfikator aplikacji użytej do nawiązania połączenia.

Właściwości parametru

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

Zestawy parametrów

RefreshToken

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

ServicePrincipalCertificate

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

-CertificateThumbprint

Odcisk palca certyfikatu cyfrowego klucza publicznego X.509.

Właściwości parametru

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

Zestawy parametrów

RefreshToken

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

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	por

Zestawy parametrów

(All)

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

-Credential

Udostępnia identyfikator aplikacji i wpis tajny dla poświadczeń jednostki usługi.

Właściwości parametru

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

Zestawy parametrów

RefreshToken

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

-Environment

Środowisko zawierające konto.

Właściwości parametru

Typ:	EnvironmentName
Domyślna wartość:	None
Dopuszczalne wartości:	AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

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

-RefreshToken

Token odświeżania używany do nawiązywania połączenia.

Właściwości parametru

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

Zestawy parametrów

RefreshToken

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

-ServicePrincipal

Wskazuje, że to konto jest uwierzytelniane przez podanie poświadczeń jednostki usługi.

Właściwości parametru

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

Zestawy parametrów

ServicePrincipalCertificate

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

-Tenant

Identyfikator lub nazwa dzierżawy.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Domena, Identyfikator najemcy

Zestawy parametrów

User

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

AccessToken

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

RefreshToken

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

-UseDeviceAuthentication

Użyj uwierzytelniania kodu urządzenia zamiast kontrolki przeglądarki.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Urządzenie, DeviceAuth, Kod urządzenia

Zestawy parametrów

User

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

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Wi

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	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

None

Dane wyjściowe

Microsoft.Online.SecMgmt.PowerShell.Models.Authentication.MgmtContext