New-AzureRmADSpCredential

Modul:

AzureRM.Resources

Hitelesítő adatokat ad hozzá egy meglévő szolgáltatásnévhez.

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

Syntax

New-AzureRmADSpCredential
   -ObjectId <Guid>
   [-Password <SecureString>]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADSpCredential
   -ObjectId <Guid>
   -CertValue <String>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADSpCredential
   -ServicePrincipalName <String>
   -CertValue <String>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADSpCredential
   -ServicePrincipalName <String>
   [-Password <SecureString>]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADSpCredential
   -ServicePrincipalObject <PSADServicePrincipal>
   -CertValue <String>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADSpCredential
   -ServicePrincipalObject <PSADServicePrincipal>
   [-Password <SecureString>]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

A New-AzureRmADSpCredential parancsmaggal új hitelesítő adatokat adhat hozzá, vagy hitelesítő adatokat állíthat be egy szolgáltatásnévhez. A szolgáltatásnév az objektumazonosító vagy a szolgáltatásnév nevének megadásával azonosítható.

Példák

1. példa – Új szolgáltatásnév hitelesítő adatainak létrehozása generált jelszóval

PS C:\> New-AzureRmADSpCredential -ObjectId 1f99cf81-0146-4f4e-beae-2007d0668476

Secret    : System.Security.SecureString
StartDate : 11/12/2018 9:36:05 PM
EndDate   : 11/12/2019 9:36:05 PM
KeyId     : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Type      : Password

A rendszer új jelszó-hitelesítő adatokat ad hozzá a meglévő szolgáltatásnévhez az "1f99cf81-0146-4f4e-beae-2007d0668476" objektumazonosítóval.

2. példa – Új szolgáltatásnév hitelesítő adatainak létrehozása tanúsítvány használatával

PS C:\> $cer = New-Object System.Security.Cryptography.X509Certificates.X509Certificate 
PS C:\> $cer.Import("C:\myapp.cer") 
PS C:\> $binCert = $cer.GetRawCertData() 
PS C:\> $credValue = [System.Convert]::ToBase64String($binCert)
PS C:\> New-AzureRmADSpCredential -ServicePrincipalName "http://test123" -CertValue $credValue -StartDate $cer.GetEffectiveDateString() -EndDate $cer.GetExpirationDateString()

A megadott base64 kódolású nyilvános X509-tanúsítvány ("myapp.cer") a meglévő szolgáltatásnévhez lesz hozzáadva az SPN használatával.

3. példa – Új szolgáltatásnév hitelesítő adatainak létrehozása piping használatával

PS C:\> Get-AzureRmADServicePrincipal -ObjectId 1f99cf81-0146-4f4e-beae-2007d0668476 | New-AzureRmADSpCredential

Secret    : System.Security.SecureString
StartDate : 11/12/2018 9:36:05 PM
EndDate   : 11/12/2019 9:36:05 PM
KeyId     : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Type      : Password

Lekéri a szolgáltatásnevet az "1f99cf81-0146-4f4e-beae-2007d0668476" objektumazonosítóval és a New-AzureRmADSpCredential-hoz, hogy létrehozzon egy új szolgáltatásnév-hitelesítő adatot az adott szolgáltatásnévhez egy generált jelszóval.

Paraméterek

-CertValue

Az "aszimmetrikus" hitelesítő adattípus értéke. Ez az alap 64 kódolású tanúsítványt jelöli.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:	SwitchParameter
Aliasok:	cf
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés

Típus:	IAzureContextContainer
Aliasok:	AzureRmContext, AzureCredential
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-EndDate

A hitelesítő adatok használatának érvényes záró dátuma. Az alapértelmezett záródátumérték a mai naptól számított egy év. Az aszimmetrikus típusú hitelesítő adatok esetében ezt az X509-tanúsítvány érvényességének dátumára vagy azt megelőzően kell beállítani.

Típus:	DateTime
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-ObjectId

A szolgáltatásnév objektumazonosítója a hitelesítő adatok hozzáadásához.

Típus:	Guid
Aliasok:	ServicePrincipalObjectId
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-Password

Az alkalmazáshoz társítandó jelszó.

Típus:	SecureString
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-ServicePrincipalName

A hitelesítő adatok hozzáadásához használt egyszerű szolgáltatásnév (SPN) neve.

Típus:	String
Aliasok:	SPN
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-ServicePrincipalObject

A szolgáltatásnév objektuma, amelybe a hitelesítő adatokat fel szeretné adni.

Típus:	PSADServicePrincipal
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-StartDate

A hitelesítő adatok használatának tényleges kezdő dátuma. Az alapértelmezett kezdő dátumérték ma van. Az "aszimmetrikus" típusú hitelesítő adatok esetében ezt az X509-tanúsítvány érvényességének dátumán vagy után kell beállítani.

Típus:	DateTime
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:	SwitchParameter
Aliasok:	wi
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

Guid

String

PSADServicePrincipal

Paraméterek: ServicePrincipalObject (ByValue)

SecureString

DateTime

Kimenetek

PSADCredential

Microsoft.Azure.Commands.Resources.Models.Authorization.PSADCredentialWrapper

Kapcsolódó hivatkozások

• Get-AzureRmADSpCredential
• Remove-AzureRmADSpCredential
• Get-AzureRmADServicePrincipal