Auf Englisch lesen

Freigeben über

Update-SCOMRunAsAccount

  • Referenz
Modul:
OperationsManager

Aktualisierungen die Anmeldeinformationen eines Operations Manager Run As-Kontos.

Syntax

PowerShell 
Update-SCOMRunAsAccount
      [-WindowsAccount] <WindowsCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Update-SCOMRunAsAccount
      [-BasicAccount] <BasicCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Update-SCOMRunAsAccount
      [-SimpleAccount] <SimpleCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Update-SCOMRunAsAccount
      [-DigestAccount] <DigestCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Update-SCOMRunAsAccount
      [-ActionAccount] <ActionAccountSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Update-SCOMRunAsAccount
      [-CommunityStringAccount] <CommunityStringSecureData>
      [-CommunityString] <SecureString>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Update-SCOMRunAsAccount
      [-BinaryAccount] <GenericSecureData>
      [-Path] <String>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Update-SCOMRunAsAccount aktualisiert die Anmeldeinformationen eines System Center 2019 – Operations Manager Run As Account. Ein Run As-Konto bietet Benutzern die Möglichkeit, die erforderlichen Berechtigungen für die Verwendung mit Regeln, Aufgaben, Monitoren und Entdeckungen anzugeben, die auf bestimmte Computer auf bedarfsbezogene Basis ausgerichtet sind.

Dieses Cmdlet unterstützt keine SCX-Konten (plattformübergreifende) Konten oder Simple Network Management Protocol Version 3 (SNMPv3)-Konten.

Beispiele

Beispiel 1: Aktualisieren eines Windows-Ausführens als Konto

PowerShell 
PS C:\>$WindowsAccount = Get-SCOMRunAsAccount -Name "Domain Admin"
PS C:\> $WindowsAccount | Update-SCOMRunAsAccount -RunAsCredential (Get-Credential)

In diesem Beispiel wird ein Windows Run As-Konto aktualisiert.

Der erste Befehl ruft das Run As-Kontoobjekt namens Domain Admin ab und speichert das Objekt in der $WindowsAccount Variablen.

Der zweite Befehl übergibt das in der $WindowsAccount Variable gespeicherte Ausführen als Konto an das Cmdlet "Update-SCOMRunAsAccount " mithilfe des Pipelineoperators. Dieses Cmdlet aktualisiert die Anmeldeinformationen für das Konto auf den Benutzernamen und das Kennwort, das der Benutzer bereitstellt, indem er auf die Aufforderung vom Cmdlet "Get-Credential " reagiert.

Beispiel 2: Aktualisieren einer Aktion "Als Konto ausführen"

PowerShell 
PS C:\>$UserName = "Contoso\SCOMActionAccount"
PS C:\> $Password = Read-Host -AsSecureString
PS C:\> $NewCred = new-object System.Management.Automation.PsCredential $UserName,$Password
PS C:\> Get-SCOMRunAsAccount -Name "SCOM Action Account" | Update-SCOMRunAsAccount -RunAsCredential $newCred

In diesem Beispiel werden Anmeldeinformationen für ein Aktionskonto "Ausführen als Konto" aktualisiert.

Der erste Befehl erstellt eine Zeichenfolge, die einen Aktionskontonamen enthält und die Zeichenfolge in der $UserName Variable speichert.

Der zweite Befehl fordert den Benutzer auf, eine Zeichenfolge einzugeben, die das Kennwort darstellt. Anschließend wird die Benutzereingabe als sichere Zeichenfolge in der variablen $Password gespeichert.

Der dritte Befehl erstellt ein PSCredential-Objekt mithilfe des Namens, der in der $UserName Variablen gespeichert ist, und das kennwort, das in $Password gespeichert ist. Anschließend wird das PSCredential-Objekt in der $NewCred Variable gespeichert.

Der letzte Befehl ruft das Aktionskonto namens SCOM Action Account ab. Anschließend wird der Pipelineoperator verwendet, um das Konto an das Cmdlet Update-SCOMRunAsAccount zu übergeben, das das Konto mit den Anmeldeinformationen aktualisiert, die in der $NewCred Variablen gespeichert sind.

Beispiel 3: Aktualisieren eines Community-Zeichenfolgenkontos

PowerShell 
PS C:\>Get-SCOMRunAsAccount -Name "MyCommunityStringAccount" | Update-SCOMRunAsAccount -CommunityString (Read-Host -AsSecureString)

Dieser Befehl aktualisiert Anmeldeinformationen für ein Run As-Konto, das die Community-Zeichenfolgenauthentifizierung für SNMP Version 2 verwendet. Es ruft das Community-Zeichenfolgenkonto namens MyCommunityStringAccount ab und verwendet den Pipelineoperator, um das Konto an das Cmdlet Update-SCOMRunAsAccount zu übergeben. Dieses Cmdlet aktualisiert die Communityzeichenfolge mit dem Wert, den der Benutzer als Antwort auf Eingabeaufforderungen vom Cmdlet "Read-Host " eingegeben hat. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Read-Host.

Beispiel 4: Aktualisieren eines Binärauthentifizierungskontos

PowerShell 
PS C:\>Get-SCOMRunAsAccount -Name "MyBinaryAccount" | Update-SCOMRunAsAccount -Path ".\data.txt"

In diesem Beispiel wird das Binärkontoobjekt namens MyBinaryAccount und der Pipelineoperator verwendet, um das Objekt an das Cmdlet "Update-SCOMRunAsAccount " zu übergeben. Dieses Cmdlet verwendet den Pfadparameter , um anzugeben, dass die neuen Kontodaten aus der Datei namens data.txt abgerufen werden.

Parameter

-AccountType

Gibt den Typ des Ausführen as-Kontos an. Die Pipeline füllt diesen Wert normalerweise automatisch auf.

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

-ActionAccount

Gibt ein Aktionskonto als Ausführen als Konto an.

Type:ActionAccountSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-BasicAccount

Gibt ein Run As-Konto an, das die Standardauthentifizierung verwendet.

Type:BasicCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-BinaryAccount

Gibt ein Ausführen as-Konto an, das die Binärauthentifizierung verwendet.

Type:GenericSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CommunityString

Gibt die neue Communityzeichenfolge für ein SNMP Version 2 Run As-Konto an, das die Community-Zeichenfolgenauthentifizierung verwendet.

Type:SecureString
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CommunityStringAccount

Gibt ein SNMP Version 2 Run As-Konto an, das die Community-Zeichenfolgenauthentifizierung verwendet.

Type:CommunityStringSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet erstellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Geben Sie zum Angeben des lokalen Computers den Computernamen, localhost oder einen Punkt (.) ein.

Der System Center Data Access-Dienst muss auf dem Computer gestartet werden. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Gibt das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Geben Sie ein PSCredential-Objekt an, z. B. eins, das das Get-Credential-Cmdlet zurückgibt, für diesen Parameter. Weitere Informationen zu Anmeldeinformationenobjekten geben Sie Get-Help Get-Credentialein.

Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.

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

-DigestAccount

Gibt ein Run As-Konto an, das die Standard-Digest-Webauthentifizierung verwendet.

Type:DigestCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Gibt an, dass das Cmdlet ein Objekt erstellt oder ändert, das ein Befehl in der Pipeline verwenden kann. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

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

-Path

Gibt den Pfad zu einer Datei an, die neue Anmeldeinformationen für "Run As"-Konten enthält, die die Binäre Authentifizierung verwenden.

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

-RunAsCredential

Gibt neue Anmeldeinformationen für Kontotypen an, die einen Benutzernamen und ein Kennwort verwenden.

Type:PSCredential
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SCSession

Gibt ein Array von Connection-Objekten an. Um Verbindungsobjekte abzurufen, verwenden Sie das Cmdlet Get-SCOMManagementGroupConnection .

Wenn dieser Parameter nicht angegeben wird, verwendet das Cmdlet die aktive persistente Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession-Parameter , um eine andere persistente Verbindung anzugeben. Sie können eine temporäre Verbindung zu einer Verwaltungsgruppe erstellen, indem Sie die Parameter "ComputerName " und "Anmeldeinformationen " verwenden. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SimpleAccount

Gibt ein Run As-Konto an, das einfache Webauthentifizierung verwendet.

Type:SimpleCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WindowsAccount

Gibt ein Ausführen as-Konto an, das Windows-Authentifizierung verwendet.

Type:WindowsCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False