Set-SmaAdminConfiguration
Modyfikuje ustawienia konfiguracji administracyjnej w programie SMA.
Składnia
Set-SmaAdminConfiguration
[-Telemetry <Boolean>]
[-DrainTimeInSeconds <Int32>]
[-ScriptExecutionPolicy <String>]
[-MaxJobRecords <Int32>]
[-PurgeJobsOlderThanCountDays <Int32>]
[-Force]
[-ChartTimeSliceSampleSize <ChartTimeSliceSampleSize>]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Set-SmaAdminConfiguration modyfikuje ustawienia konfiguracji administracyjnej w programie Service Management Automation (SMA). Określ punkt końcowy usługi internetowej i, w razie potrzeby, port.
Użyj tego polecenia cmdlet, aby skonfigurować następujące ustawienia:
- Czy udostępniać dane diagnostyczne i dane użycia firmie Microsoft
- Czas opróżniania
- Zasady wykonywania skryptu
- Rozmiar próbki wycinka czasu wykresu
- Maksymalna liczba rekordów zadań do przechowywania przed przeczyszczeniem najstarszych zadań
- Maksymalny wiek zadania przed przeczyszczeniem
Przykłady
Przykład 1. Modyfikowanie ustawienia konfiguracji administracyjnej
PS C:\> Set-SmaAdminConfiguration -WebServiceEndpoint "https://contoso.com/app01" -DrainTimeInSeconds 60
To polecenie ustawia czas opróżniania na 60 sekund.
Parametry
-AuthenticationType
Określa typ uwierzytelniania. Prawidłowe wartości to:
- Podstawowy
- Windows
Wartość domyślna tego parametru to Windows. Jeśli używasz uwierzytelniania podstawowego, musisz podać poświadczenia przy użyciu parametru Credential.
Typ: | String |
Dopuszczalne wartości: | Basic, Windows |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ChartTimeSliceSampleSize
Określa rozmiar próbki fragmentatora czasu wykresu. Prawidłowe wartości to:
- Mały
- Średni
- Duży
- EkstraLarge
Typ: | ChartTimeSliceSampleSize |
Dopuszczalne wartości: | Small, Medium, Large, ExtraLarge |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Credential
Określa obiekt PSCredential dla połączenia z usługą internetową SMA.
Aby uzyskać obiekt poświadczeń, użyj polecenia cmdlet Get-Credential.
Aby uzyskać więcej informacji, wpisz Get-Help Get-Credential
.
Typ: | PSCredential |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DrainTimeInSeconds
Określa czas w sekundach, po którym hosty procesu roboczego elementu Runbook kończą uruchomione zadania po zainicjowaniu usługi procesu roboczego elementu Runbook. Podczas opróżniania hosta istniejące zadania mają określony czas opróżniania w sekundach, aby zawiesić lub zakończyć w naturalny sposób, a żadne nowe zadania nie są akceptowane.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Force
Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-MaxJobRecords
Określa maksymalną liczbę rekordów zadań, które są zachowywane.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Port
Określa numer portu usługi internetowej SMA.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PurgeJobsOlderThanCountDays
Określa liczbę dni przechowywania historii zadań. Zadania starsze niż ta wartość są czyszczone.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ScriptExecutionPolicy
Określa zasady wykonywania programu Windows PowerShell dla zadań runbook na hostach procesów roboczych.
Aby uzyskać informacje o zasadach wykonywania, wpisz Get-Help about_Execution_Policies
.
Prawidłowe wartości dla tego parametru to:
- Ograniczone. Nie można uruchamiać skryptów. Program Windows PowerShell można używać tylko w trybie interaktywnym.
- AllSigned. Można uruchamiać tylko skrypty podpisane przez zaufanego wydawcę.
- RemoteSigned. Pobrane skrypty muszą być podpisane przez zaufanego wydawcę przed uruchomieniem skryptów.
- Nieograniczony. Brak ograniczeń; można uruchomić wszystkie skrypty programu Windows PowerShell.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Telemetry
Wskazuje, czy udostępnić dane diagnostyczne i dane użycia firmie Microsoft. Dopuszczalne wartości tego parametru to:
- $True. Udostępnianie danych diagnostycznych i danych użycia firmie Microsoft.
- $False. Nie udostępniaj danych diagnostycznych i danych użycia firmie Microsoft.
Typ: | Boolean |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WebServiceEndpoint
Określa punkt końcowy jako adres URL usługi internetowej SMA. Należy dołączyć protokół, na przykład http:// lub https://.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |