Udostępnij za pośrednictwem

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 programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

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.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:AzureSMProfile
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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