Udostępnij przez

Get-AzurePublishSettingsFile

  • Odwołanie
Moduł:
Azure

Pobiera plik ustawień publikowania dla subskrypcji platformy Azure.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API zarządzania usługami. Zobacz moduł Az programu PowerShell, aby uzyskać polecenia cmdlet do zarządzania zasobami usługi Azure Resource Manager.

Składnia

Get-AzurePublishSettingsFile
   [-Environment <String>]
   [-Realm <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-AzurePublishSettingsFile pobiera plik ustawień publikowania dla subskrypcji na twoim koncie. Po zakończeniu wykonywania polecenia można użyć polecenia cmdlet Import-PublishSettingsFile , aby ustawić ustawienia w pliku dostępnym dla programu Windows PowerShell.

Aby udostępnić konto platformy Azure programowi Windows PowerShell, możesz użyć pliku ustawień publikowania lub polecenia cmdlet Add-AzureAccount . Pliki ustawień publikowania umożliwiają przygotowanie sesji z wyprzedzeniem, dzięki czemu można uruchamiać skrypty i zadania w tle nienadzorowane. Jednak nie wszystkie usługi obsługują pliki ustawień publikowania. Na przykład moduł AzureResourceManager nie obsługuje plików ustawień publikowania.

Po uruchomieniu polecenia Get-AzurePublishSettingsFile zostanie otwarta domyślna przeglądarka i zostanie wyświetlony monit o zalogowanie się do konta platformy Azure, wybranie subskrypcji i wybranie lokalizacji systemu plików dla pliku ustawień publikowania. Następnie pobiera plik ustawień publikowania dla subskrypcji do wybranego pliku.

"Plik ustawień publikowania" to plik XML z rozszerzeniem nazwy pliku publishsettings. Plik zawiera zakodowany certyfikat, który zapewnia poświadczenia zarządzania dla subskrypcji platformy Azure.

Uwaga dotycząca zabezpieczeń: Pliki ustawień publikowania zawierają poświadczenia używane do administrowania subskrypcjami i usługami platformy Azure. Jeśli złośliwi użytkownicy uzyskują dostęp do pliku ustawień publikowania, mogą edytować, tworzyć i usuwać usługi platformy Azure. Najlepszym rozwiązaniem w zakresie zabezpieczeń jest zapisanie pliku w lokalizacji w folderze Pobrane lub Dokumenty, a następnie usunięcie go po zaimportowaniu ustawień za pomocą polecenia cmdlet Import-AzurePublishSettingsFile .

W tym temacie opisano polecenie cmdlet w wersji 0.8.10 modułu Microsoft Azure PowerShell. Aby uzyskać wersję używanego modułu, w konsoli programu Azure PowerShell wpisz (Get-Module -Name Azure).Version.

Przykłady

Przykład 1. Pobieranie pliku ustawień publikowania

PS C:\> Get-AzurePublishSettingsFile

To polecenie otwiera domyślną przeglądarkę, nawiązuje połączenie z kontem platformy Windows Azure, a następnie pobiera plik publishsettings dla twojego konta.

Przykład 2. Określanie obszaru

PS C:\> Get-AzurePublishSettingsFile -Realm contoso.com -Passthru

To polecenie pobiera plik ustawień publikowania dla konta w domenie contoso.com. Użyj polecenia z parametrem Obszar podczas logowania się do platformy Azure przy użyciu konta organizacyjnego zamiast konta Microsoft.

Parametry

-Environment

Określa środowisko platformy Azure.

Środowisko platformy Azure niezależne wdrożenie platformy Microsoft Azure, takie jak AzureCloud for global Azure i AzureChinaCloud for Azure obsługiwane przez firmę 21Vianet w Chinach. Możesz również tworzyć lokalne środowiska platformy Azure przy użyciu pakietu Azure Pack i poleceń cmdlet WAPack. Aby uzyskać więcej informacji, zobacz Azure Pack.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Zwraca $True, jeśli polecenie powiedzie się i $False, jeśli zakończy się niepowodzeniem. Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Realm

Określa organizację w identyfikatorze organizacyjnym. Jeśli na przykład zalogujesz się do platformy Azure jako admin@contoso.com, wartość parametru Obszaru jest contoso.com. Użyj tego parametru, gdy użyjesz identyfikatora organizacyjnego, aby zalogować się do witryny Azure Portal. Ten parametr nie jest wymagany w przypadku korzystania z konta Microsoft, takiego jak konto outlook.com lub live.com.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

None

Możesz przekazać dane wejściowe do tego polecenia cmdlet według nazwy właściwości, ale nie według wartości.

Dane wyjściowe

None or System.Boolean

Jeśli używasz parametru PassThru , to polecenie cmdlet zwraca wartość logiczną. W przeciwnym razie to polecenie cmdlet nie zwraca żadnych danych wyjściowych