Connect-SecMgmtAccount

Modul:

SecMgmt Module

Stellen Sie eine Verbindung mit der Microsoft-Cloud mit einem authentifizierten Konto für die Verwendung mit den Cmdlets her.

Syntax

User (Standardwert)

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

Beschreibung

Stellen Sie eine Verbindung mit der Microsoft-Cloud mit einem authentifizierten Konto für die Verwendung mit den Cmdlets her.

Beispiele

Beispiel 1

PS C:\> Connect-SecMgmtAccount

Mit diesem Befehl stellen Sie eine Verbindung mit der Microsoft-Cloud her.

Beispiel 2

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

Mit dem ersten Befehl werden die Anmeldeinformationen für den Dienstprinzipal (Anwendungsbezeichner und geheimer Dienstprinzipalschlüssel) abgerufen und dann in der Variablen $credential gespeichert. Der zweite Befehl stellt eine Verbindung mit der Microsoft-Cloud her, indem er die Anmeldeinformationen des Dienstprinzipals verwendet, die in $credential für den angegebenen Mandanten gespeichert sind. Der Parameter "ServicePrincipal switch" gibt an, dass sich das Konto als Dienstprinzipal authentifiziert.

Beispiel 3

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

Stellt eine Verbindung mit der Microsoft-Cloud mithilfe eines Aktualisierungstokens her, das mit einer nativen Anwendung generiert wurde.

Beispiel 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

Stellt eine Verbindung mit der Microsoft-Cloud mithilfe eines Aktualisierungstokens her, das mithilfe einer Webanwendung generiert wurde.

Parameter

-AccessToken

Zugriffstoken, das zum Herstellen einer Verbindung verwendet wird.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

AccessToken

Position:	Named
Obligatorisch.:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-ApplicationId

Kennung der Anwendung, die für die Verbindung verwendet wird.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

RefreshToken

Position:	Named
Obligatorisch.:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

ServicePrincipalCertificate

Position:	Named
Obligatorisch.:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-CertificateThumbprint

Zertifikatfingerabdruck eines X.509-Zertifikats mit digitalem öffentlichem Schlüssel.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

RefreshToken

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	vgl

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Credential

Stellt den Anwendungsbezeichner und den geheimen Schlüssel für die Anmeldeinformationen des Dienstprinzipals bereit.

Parametereigenschaften

Typ:	PSCredential
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

RefreshToken

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Environment

Umgebung, die das Konto enthält.

Parametereigenschaften

Typ:	EnvironmentName
Standardwert:	None
Zulässige Werte:	AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-RefreshToken

Aktualisierungstoken, das zum Herstellen einer Verbindung verwendet wird.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

RefreshToken

Position:	Named
Obligatorisch.:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-ServicePrincipal

Gibt an, dass sich dieses Konto authentifiziert, indem Dienstprinzipalanmeldeinformationen bereitgestellt werden.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

ServicePrincipalCertificate

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Tenant

Bezeichner oder Name für den Mandanten.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	Domäne, Mieter-ID

Parametersätze

User

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

AccessToken

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

RefreshToken

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-UseDeviceAuthentication

Verwenden Sie die Gerätecodeauthentifizierung anstelle eines Browsersteuerelements.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	Gerät, DeviceAuth, DeviceCode

Parametersätze

User

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	Wi

Parametersätze

(All)

Position:	Named
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

None

Ausgaben

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