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
Paraméterek: ApplicationObject (ByValue)