Megosztás a következőn keresztül:


New-AzureRmADAppCredential

Hitelesítő adatokat ad hozzá egy meglévő alkalmazáshoz.

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-AzureRmADAppCredential
   -ObjectId <Guid>
   -Password <SecureString>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmADAppCredential
   -ObjectId <Guid>
   -CertValue <String>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmADAppCredential
   -ApplicationId <Guid>
   -CertValue <String>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmADAppCredential
   -ApplicationId <Guid>
   -Password <SecureString>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmADAppCredential
   -DisplayName <String>
   -Password <SecureString>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmADAppCredential
   -DisplayName <String>
   -CertValue <String>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmADAppCredential
   -ApplicationObject <PSADApplication>
   -CertValue <String>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmADAppCredential
   -ApplicationObject <PSADApplication>
   -Password <SecureString>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

A New-AzureRmADAppCredential parancsmag használható új hitelesítő adatok hozzáadására vagy egy alkalmazás hitelesítő adatainak igénylésére. Az alkalmazás az alkalmazás objektumazonosítójának vagy az alkalmazásazonosítónak a megadásával azonosítható.

Példák

1. példa – Új alkalmazás hitelesítő adatainak létrehozása jelszóval

PS C:\> $SecureStringPassword = ConvertTo-SecureString -String "password" -AsPlainText -Force
PS C:\> New-AzureRmADAppCredential -ObjectId 1f89cf81-0146-4f4e-beae-2007d0668416 -Password $SecureStringPassword

A rendszer új jelszóval kapcsolatos hitelesítő adatokat ad hozzá a meglévő alkalmazáshoz az "1f89cf81-0146-4f4e-beae-2007d0668416" objektumazonosítóval.

2. példa – Új alkalmazás 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-AzureRmADAppCredential -ApplicationId 00001111-aaaa-2222-bbbb-3333cccc4444 -CertValue $credValue -StartDate $cer.GetEffectiveDateString() -EndDate $cer.GetExpirationDateString()

A megadott base64 kódolású nyilvános X509-tanúsítvány ("myapp.cer") hozzáadódik a meglévő alkalmazáshoz a "00001111-aaaa-2222-bbbb-3333cccc4444" alkalmazásazonosítóval.

3. példa – Új alkalmazás hitelesítő adatainak létrehozása piping használatával

PS C:\> $SecureStringPassword = ConvertTo-SecureString -String "password" -AsPlainText -Force
PS C:\> Get-AzureRmADApplication -ObjectId 1f89cf81-0146-4f4e-beae-2007d0668416 | New-AzureRmADAppCredential -Password $SecureStringPassword

Lekéri az alkalmazást az "1f89cf81-0146-4f4e-beae-2007d0668416" objektumazonosítóval, és a New-AzureRmADAppCredential-ra állítva létrehoz egy új alkalmazás-hitelesítő adatokat az adott alkalmazáshoz a megadott jelszóval.

Paraméterek

-ApplicationId

Az alkalmazás alkalmazásazonosítója a hitelesítő adatok hozzáadásához.

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

-ApplicationObject

A hitelesítő adatokat hozzáadni kívánt alkalmazásobjektum.

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

-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:False
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

-DisplayName

Az alkalmazás megjelenítendő neve.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
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

Az alkalmazás objektumazonosítója a hitelesítő adatok hozzáadásához.

Típus:Guid
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ő: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:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

Guid

String

PSADApplication

Paraméterek: ApplicationObject (ByValue)

SecureString

DateTime

Kimenetek

PSADCredential