New-CMAccessAccount
Fügt einem Zugriffskonto Benutzer oder Gruppen hinzu.
Syntax
New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
[-InputObject] <IResultObject>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-ApplicationId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-ApplicationName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-BootImageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-BootImageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-DriverPackageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-DriverPackageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-OperatingSystemImageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-OperatingSystemImageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-OperatingSystemInstallerId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-OperatingSystemInstallerName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-PackageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-PackageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-SoftwareUpdateDeploymentPackageId <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAccessAccount
-Access <AccessRight>
-AccountType <AccessAccountType>
-SoftwareUpdateDeploymentPackageName <String>
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet New-CMAccessAccount fügt einem Zugriffskonto Benutzer oder Gruppen hinzu.
Ein Zugriffskonto ist eine Liste von Benutzern oder Gruppen, die auf einen etablierten Dienst oder eine Anwendung zugreifen können, die sich auf einem Verteilungspunkt befindet. Mitglieder im Verbindungszugriffskonto des Softwareupdatepunkts können beispielsweise auf zwei Dienste zum Verwalten von Softwareupdates zugreifen: Windows Server Update Services (WSUS) und WSUS Synchronization Manager.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Ändern des Zugriffs auf eine Anwendung mithilfe der Anwendungs-ID
PS XYZ:\> $ID = Get-CMAccessAccount -ApplicationID "12994680"
PS XYZ:\> New-CMAccessAccount -ApplicationID $ID -Type WindowsUser Username "CONTOSO\EDaugherty" -Access "FullControl"Der erste Befehl ruft eine Anwendungs-ID ab und speichert sie dann in der variablen $ID.
Der zweite Befehl ruft die Anwendung ab, die von $ID identifiziert wird, und fügt dem Zugriffskonto einen Benutzer hinzu. Die Berechtigungen des neuen Benutzers sind auf FullControl festgelegt.
Parameter
-Access
Gibt die Zugriffsrechte an, die einem Zugriffskonto zugeordnet sind. Gültige Werte sind: Kein Zugriff, Lesen, Ändern und Vollzugriff.
| Typ: | AccessRight |
| Zulässige Werte: | NoAccess, Read, Change, FullControl |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AccountType
Gibt einen Kontotyp an. Gültige Werte sind: Gast, Benutzer, WindowsGroup und WindowsUser.
| Typ: | AccessAccountType |
| Zulässige Werte: | User, Guest, Administrator, WindowsUser, WindowsGroup |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ApplicationId
Gibt die ID einer Anwendung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ApplicationName
Gibt den Namen einer Anwendung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-BootImageId
Gibt die ID eines Startimages an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-BootImageName
Gibt den Namen eines Startimages an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DriverPackageId
Gibt die ID eines Treiberpakets an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DriverPackageName
Gibt den Namen eines Treiberpakets an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InputObject
Gibt die Eingabe für dieses Cmdlet an. Sie können diesen Parameter verwenden oder die Eingabe an dieses Cmdlet weiterleiten.
| Typ: | IResultObject |
| Aliase: | Application, BootImage, DriverPackage, OperatingSystemImage, OperatingSystemInstaller, Package, SoftwareUpdateDeploymentPackage |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-OperatingSystemImageId
Gibt die ID eines Betriebssystemabbilds an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OperatingSystemImageName
Gibt den Namen eines Betriebssystemabbilds an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OperatingSystemInstallerId
Gibt die ID eines Betriebssysteminstallationsprogramms an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OperatingSystemInstallerName
Gibt den Namen eines Betriebssysteminstallationsprogramms an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PackageId
Gibt die ID eines bereitgestellten Softwareskripts oder -programms an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PackageName
Gibt den Namen eines bereitgestellten Softwareskripts oder -programms an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SoftwareUpdateDeploymentPackageId
Gibt die ID eines bereitgestellten Softwareupdates an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SoftwareUpdateDeploymentPackageName
Gibt den Namen eines bereitgestellten Softwareupdates an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserName
Gibt einen Windows-Benutzerkontonamen im Format Domäne\Benutzer an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
IResultObject