Delen via

Update-SCOMRunAsAccount

  • Referentie
Module:
OperationsManager

Hiermee worden de referenties van een Uitvoeren als-account van Operations Manager bijgewerkt.

Syntaxis

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

Description

De cmdlet Update-SCOMRunAsAccount werkt de referenties van een Uitvoeren als-account van System Center - Operations Manager bij. Een Uitvoeren als-account biedt gebruikers de mogelijkheid om de benodigde machtigingen op te geven voor gebruik met regels, taken, monitors en ontdekkingen die zijn gericht op specifieke computers op basis van behoefte.

Deze cmdlet biedt geen ondersteuning voor SCX-accounts (platformoverschrijdende) of SNMPv3-accounts (Simple Network Management Protocol versie 3). Gebruik in plaats daarvan Get-SCOMRunAsAccount om SCX-accounts bij te werken.

Voorbeelden

Voorbeeld 1: Een Windows Uitvoeren als-account bijwerken

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

In dit voorbeeld wordt een Windows Uitvoeren als-account bijgewerkt.

Met de eerste opdracht wordt het Uitvoeren als-accountobject met de naam Domeinbeheerder opgehaald en wordt het object opgeslagen in de $WindowsAccount variabele.

Met de tweede opdracht wordt het Uitvoeren als-account dat is opgeslagen in de $WindowsAccount variabele doorgegeven aan de cmdlet Update-SCOMRunAsAccount met behulp van de pijplijnoperator. Deze cmdlet werkt de referenties voor het account bij naar de gebruikersnaam en het wachtwoord die de gebruiker verstrekt door te reageren op de prompt van de Get-Credential cmdlet.

Voorbeeld 2: Een Uitvoeren als-account voor een actie bijwerken

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 dit voorbeeld worden referenties bijgewerkt voor een Uitvoeren als-account voor een actie.

Met de eerste opdracht maakt u een tekenreeks die een actieaccountnaam bevat en slaat u de tekenreeks op in de variabele $UserName.

Met de tweede opdracht wordt de gebruiker gevraagd een tekenreeks in te voeren die het wachtwoord vertegenwoordigt. Vervolgens wordt de gebruikersinvoer opgeslagen als een beveiligde tekenreeks in de variabele $Password.

Met de derde opdracht maakt u een PSCredential-object met behulp van de naam die is opgeslagen in de variabele $UserName en het wachtwoord dat is opgeslagen in $Password. Vervolgens wordt het object PSCredential opgeslagen in de variabele $NewCred.

Met de laatste opdracht wordt het actieaccount met de naam SCOM Action Account ophaalt. Vervolgens wordt de pijplijnoperator gebruikt om het account door te geven aan de Update-SCOMRunAsAccount cmdlet, waarmee het account wordt bijgewerkt met de referenties die zijn opgeslagen in de variabele $NewCred.

Voorbeeld 3: Een communityreeksaccount bijwerken

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

Met deze opdracht worden referenties bijgewerkt voor een Uitvoeren als-account dat gebruikmaakt van verificatie van communityreeksen voor SNMP versie 2. Het haalt het communityreeksaccount MyCommunityStringAccount op en gebruikt de pijplijnoperator om het account door te geven aan de cmdlet Update-SCOMRunAsAccount. Met deze cmdlet wordt de communitytekenreeks bijgewerkt met de waarde die de gebruiker invoert als reactie op vragen van de Read-Host cmdlet. Typ Get-Help Read-Hostvoor meer informatie.

Voorbeeld 4: Een account voor binaire verificatie bijwerken

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

In dit voorbeeld wordt het binaire accountobject MyBinaryAccount opgehaald en wordt de pijplijnoperator gebruikt om het object door te geven aan de cmdlet Update-SCOMRunAsAccount. Deze cmdlet gebruikt de parameter Path om aan te geven dat de nieuwe accountgegevens worden opgehaald uit het bestand met de naam data.txt.

Parameters

-AccountType

Hiermee geeft u het type van het Uitvoeren als-account. De pijplijn vult deze waarde doorgaans automatisch in.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ActionAccount

Hiermee geeft u een actieaccount op als een Uitvoeren als-account.

Type:ActionAccountSecureData
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-BasicAccount

Hiermee geeft u een Uitvoeren als-account op dat gebruikmaakt van basisverificatie.

Type:BasicCredentialSecureData
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-BinaryAccount

Hiermee geeft u een Uitvoeren als-account op dat gebruikmaakt van binaire verificatie.

Type:GenericSecureData
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-CommunityString

Hiermee geeft u de nieuwe communitytekenreeks voor een SNMP-versie 2 Uitvoeren als-account dat gebruikmaakt van verificatie van communityreeksen.

Type:SecureString
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CommunityStringAccount

Hiermee geeft u een SNMP versie 2 Uitvoeren als-account dat gebruikmaakt van verificatie van communityreeksen.

Type:CommunityStringSecureData
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u een matrix van namen van computers. Met de cmdlet worden tijdelijke verbindingen met beheergroepen voor deze computers tot stand gebracht. U kunt NetBIOS-namen, IP-adressen of FQDN's (Fully Qualified Domain Names) gebruiken. Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

De System Center Data Access-service moet op de computer worden gestart. Als u geen computer opgeeft, gebruikt de cmdlet de computer voor de huidige beheergroepverbinding.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u het gebruikersaccount waaronder de verbinding met de beheergroep wordt uitgevoerd. Geef een PSCredential--object op, zoals een object dat door de Get-Credential cmdlet wordt geretourneerd voor deze parameter. Typ Get-Help Get-Credentialvoor meer informatie over referentieobjecten.

Als u een computer opgeeft in de parameter ComputerName, gebruikt u een account dat toegang heeft tot die computer. De standaardwaarde is de huidige gebruiker.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DigestAccount

Hiermee geeft u een Uitvoeren als-account op dat gebruikmaakt van standaardsamenvattingswebverificatie.

Type:DigestCredentialSecureData
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Geeft aan dat de cmdlet een object maakt of wijzigt dat een opdracht in de pijplijn kan gebruiken. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Hiermee geeft u het pad naar een bestand met nieuwe referentiegegevens voor Uitvoeren als-accounts die binaire verificatie gebruiken.

Type:String
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsCredential

Hiermee geeft u nieuwe referenties op voor accounttypen die een gebruikersnaam en wachtwoord gebruiken.

Type:PSCredential
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SCSession

Hiermee geeft u een matrix van Connection-objecten. Gebruik de cmdlet Get-SCOMManagementGroupConnection om Connection-objecten op te halen.

Als deze parameter niet is opgegeven, gebruikt de cmdlet de actieve permanente verbinding met een beheergroep. Gebruik de parameter SCSession om een andere permanente verbinding op te geven. U kunt een tijdelijke verbinding met een beheergroep maken met behulp van de parameters ComputerName en Credential. Typ Get-Help about_OpsMgr_Connectionsvoor meer informatie.

Type:Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SimpleAccount

Hiermee geeft u een Uitvoeren als-account op dat gebruikmaakt van eenvoudige webverificatie.

Type:SimpleCredentialSecureData
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WindowsAccount

Hiermee geeft u een Uitvoeren als-account op dat gebruikmaakt van Windows-verificatie.

Type:WindowsCredentialSecureData
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False