Set-AzureSubscription
Azure-előfizetés módosítása.
Feljegyzés
A jelen dokumentációban hivatkozott parancsmagok az Azure Service Manager (ASM) API-kat használó örökölt Azure-erőforrások kezelésére szolgálnak. Ez az örökölt PowerShell-modul nem ajánlott új erőforrások létrehozásakor, mivel az ASM a kivonásra van ütemezve. További információkért lásd az Azure Service Manager kivonását.
Az Az PowerShell-modul az ajánlott PowerShell-modul az Azure Resource Manager-erőforrások PowerShell-lel való kezeléséhez.
Syntax
Set-AzureSubscription
-SubscriptionId <String>
[-Certificate <X509Certificate2>]
[-ServiceEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-CurrentStorageAccountName <String>]
[-Context <AzureStorageContext>]
[-Environment <String>]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Set-AzureSubscription
-SubscriptionName <String>
[-Certificate <X509Certificate2>]
[-ServiceEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-CurrentStorageAccountName <String>]
[-Context <AzureStorageContext>]
[-Environment <String>]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Set-AzureSubscription
-SubscriptionName <String>
-SubscriptionId <String>
-Certificate <X509Certificate2>
[-ServiceEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-CurrentStorageAccountName <String>]
[-Context <AzureStorageContext>]
[-Environment <String>]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
A Set-AzureSubscription parancsmag létrehozza és módosítja egy Azure-előfizetési objektum tulajdonságait. Ezzel a parancsmaggal olyan Azure-előfizetésben dolgozhat, amely nem az alapértelmezett előfizetése, vagy módosíthatja az aktuális tárfiókját. Az aktuális és az alapértelmezett előfizetésekkel kapcsolatos információkért tekintse meg a Select-AzureSubscription parancsmagot.
Ez a parancsmag egy Azure-előfizetési objektumon működik, nem a tényleges Azure-előfizetésen. Azure-előfizetés létrehozásához és kiépítéséhez látogasson el az Azure Portalra (https://azure.microsoft.com/).
Ez a parancsmag módosítja az Add-AzureAccount vagy az Import-AzurePublishSettingsFile parancsmag használatakor létrehozott előfizetési adatfájl adatait egy Azure-fiók Windows PowerShellhez való hozzáadásához.
Ez a témakör a Microsoft Azure PowerShell modul 0.8.10-es verziójában található parancsmagot ismerteti.
A használt modul verziójának lekéréséhez írja be (Get-Module -Name Azure).Version
az Azure PowerShell-konzolba.
Példák
1. példa: Meglévő előfizetés módosítása1
C:\PS> $thumbprint = <Thumbprint-2>
C:\PS> $differentCert = Get-Item cert:\\CurrentUser\My\$thumbprint
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $differentCert
Ez a példa módosítja a ContosoEngineering nevű előfizetés tanúsítványát.
2. példa: A szolgáltatásvégpont módosítása
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -ServiceEndpoint "https://management.core.contoso.com"
Ez a parancs hozzáad vagy módosít egy egyéni szolgáltatásvégpontot a ContosoEngineering-előfizetéshez.
3. példa: Tulajdonságértékek törlése
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $null -ResourceManagerEndpoint $Null
Ez a parancs null értékűre állítja a Tanúsítvány és a ResourceManagerEndpoint tulajdonság értékeit ($Null). Ez törli a tulajdonságok értékeit anélkül, hogy más beállításokat módosítana.
4. példa: Alternatív előfizetési adatfájl használata
C:\PS> Set-AzureSubscription -SubscriptionName ContosoFinance -SubscriptionDataFile C:\Azure\SubscriptionData.xml -CurrentStorageAccount ContosoStorage01
Ez a parancs a ContosoFinance-előfizetés aktuális tárfiókját ContosoStorage01-re módosítja. A parancs az SubscriptionDataFile paraméter használatával módosítja az adatokat a C:\Azure\SubscriptionData.xml előfizetési adatfájlban. A Set-AzureSubscription alapértelmezés szerint a központi felhasználói profil alapértelmezett előfizetési adatfájlját használja.
Paraméterek
-Certificate
Típus: | X509Certificate2 |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Context
Típus: | AzureStorageContext |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CurrentStorageAccountName
Típus: | String |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Environment
Egy Azure-környezetet határoz meg.
Az Azure-környezet a Microsoft Azure független üzembe helyezése, például az AzureCloud a globális Azure-hoz és az Azure Azure-hoz készült AzureChinaCloud, amelyet a 21Vianet üzemeltet Kínában. Helyszíni Azure-környezeteket az Azure Pack és a WAPack parancsmagok használatával is létrehozhat. További információ: Azure Pack.
Típus: | String |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Visszaadja $True, ha a parancs sikeres, és $False, ha sikertelen. Alapértelmezés szerint ez a parancsmag nem ad vissza kimenetet.
Típus: | SwitchParameter |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
Azt az Azure-profilt adja meg, amelyből a parancsmag beolvassa. Ha nem ad meg profilt, ez a parancsmag a helyi alapértelmezett profilból olvas be.
Típus: | AzureSMProfile |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceManagerEndpoint
Meghatározza az Azure Resource Manager-adatok végpontjait, beleértve a fiókhoz társított erőforráscsoportok adatait is. Az Azure Resource Managerrel kapcsolatos további információkért lásd: Azure Resource Manager-parancsmagok (https://go.microsoft.com/fwlink/?LinkID=394765) és a Windows PowerShell használata a Resource Managerrel (https://go.microsoft.com/fwlink/?LinkID=394767).
Típus: | String |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceEndpoint
Típus: | String |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SubscriptionId
Típus: | String |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SubscriptionName
Típus: | String |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Bevitelek
None
Ehhez a parancsmaghoz a bemenetet tulajdonságnév alapján, érték alapján azonban nem lehet becsúszni.
Kimenetek
None or System.Boolean
A PassThru paraméter használatakor ez a parancsmag logikai értéket ad vissza. Alapértelmezés szerint ez a parancsmag nem ad vissza kimenetet.