Get-AzurePublishSettingsFile
Letölti egy Azure-előfizetés közzétételi beállításfájlját.
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
Get-AzurePublishSettingsFile
[-Environment <String>]
[-Realm <String>]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
A Get-AzurePublishSettingsFile parancsmag letölt egy közzétételi beállításfájlt egy előfizetéshez a fiókjában. A parancs befejeződésekor az Import-PublishSettingsFile parancsmaggal elérhetővé teheti a fájl beállításait a Windows PowerShell számára.
Ha elérhetővé szeretné tenni Azure-fiókját a Windows PowerShell számára, használhat közzétételi beállításokat vagy az Add-AzureAccount parancsmagot. A közzétételi beállítások fájljaival előre előkészítheti a munkamenetet, hogy felügyelet nélkül futtathassa a szkripteket és a háttérfeladatokat. Azonban nem minden szolgáltatás támogatja a közzétételi beállítások fájljait. Az AzureResourceManager modul például nem támogatja a közzétételi beállítások fájljait.
A Get-AzurePublishSettingsFile futtatásakor megnyitja az alapértelmezett böngészőt, és kéri, hogy jelentkezzen be az Azure-fiókjába, válasszon ki egy előfizetést, és válasszon egy fájlrendszerbeli helyet a közzétételi beállításfájlhoz. Ezután letölti az előfizetés közzétételi beállításokat tartalmazó fájlját a kiválasztott fájlba.
A "közzétételi beállítások fájlja" egy .publishsettings fájlnévkiterjesztéssel rendelkező XML-fájl. A fájl egy kódolt tanúsítványt tartalmaz, amely felügyeleti hitelesítő adatokat biztosít az Azure-előfizetésekhez.
Biztonsági megjegyzés: A közzétételi beállítások fájljai olyan hitelesítő adatokat tartalmaznak, amelyek az Azure-előfizetések és -szolgáltatások felügyeletére szolgálnak. Ha a rosszindulatú felhasználók hozzáférnek a közzétételi beállítások fájljához, szerkeszthetik, létrehozhatják és törölhetik az Azure-szolgáltatásokat. Ajánlott biztonsági eljárásként mentse a fájlt a Letöltések vagy dokumentumok mappába, majd törölje azt az Import-AzurePublishSettingsFile parancsmaggal a beállítások importálá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: Közzétételi beállításfájl letöltése
PS C:\> Get-AzurePublishSettingsFile
Ez a parancs megnyitja az alapértelmezett böngészőt, csatlakozik a Windows Azure-fiókjához, majd letölti a .publishsettings fájlt a fiókjához.
2. példa: Tartomány megadása
PS C:\> Get-AzurePublishSettingsFile -Realm contoso.com -Passthru
Ez a parancs letölti a contoso.com tartományban lévő fiók közzétételi beállítások fájljának letöltését. Ha Microsoft-fiók helyett szervezeti fiókkal jelentkezik be az Azure-ba, használjon egy parancsot a Realm paraméterrel.
Paraméterek
-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 |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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 |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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 |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Realm
A szervezetet egy szervezeti azonosítóban adja meg. Ha például az Azure-ba jelentkezik be, admin@contoso.coma Tartomány paraméter értéke contoso.com. Ezt a paramétert akkor használja, ha szervezeti azonosítót használ az Azure Portalra való bejelentkezéshez. Ez a paraméter nem szükséges Microsoft-fiók, például outlook.com vagy live.com-fiók használatakor.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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. Ellenkező esetben ez a parancsmag nem ad vissza kimenetet