Freigeben über


Set-AzureNetworkSecurityGroupAssociation

Ordnet eine Netzwerksicherheitsgruppe einem virtuellen Computer, einer PaaS-Rolle oder einem Netzwerkadapter zu.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

Set-AzureNetworkSecurityGroupAssociation
   -Name <String>
   [-Force]
   [-PassThru]
   -VirtualNetworkName <String>
   -SubnetName <String>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Set-AzureNetworkSecurityGroupAssociation
   -Name <String>
   [-Force]
   [-PassThru]
   -VM <PersistentVMRoleContext>
   -ServiceName <String>
   [-NetworkInterfaceName <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Set-AzureNetworkSecurityGroupAssociation
   -Name <String>
   [-Force]
   [-PassThru]
   [-Slot <String>]
   -RoleName <String>
   -ServiceName <String>
   [-NetworkInterfaceName <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureNetworkSecurityGroupAssociation ordnet eine Netzwerksicherheitsgruppe einem virtuellen Computer, einer Plattform als Dienstrolle (PaaS) oder einem Netzwerkadapter zu.

Beispiele

Beispiel 1: Zuweisen eines virtuellen Computers zu einer Netzwerksicherheitsgruppe

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "ContosoVM06" | Set-AzureNetworkSecurityGroupAssociation -Name "ContosoNetworkSecurityGroup"

Dieser Befehl ruft einen virtuellen Computer namens ContosoVM06 für den Dienst contosoService ab und übergibt dieses virtuelle Computerobjekt an das aktuelle Cmdlet. Das aktuelle Cmdlet weist die Netzwerksicherheitsgruppe "ContosoNetworkSecurityGroup" diesem virtuellen Computer zu.

Parameter

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der Netzwerksicherheitsgruppe an, die dieses Cmdlet festlegt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NetworkInterfaceName

Gibt den Namen des Netzwerkadapters an, auf den dieses Cmdlet die Netzwerksicherheitsgruppe anwendet.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RoleName

Gibt den Namen einer PaaS-Rolle an, auf die dieses Cmdlet die Netzwerksicherheitsgruppe anwendet.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServiceName

Gibt den Namen eines Clouddiensts an. Die PaaS-Rolle gehört zum Dienst, den dieser Parameter angibt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Slot

Gibt einen PaaS-Steckplatz an. Die PaaS-Rolle, für die dieses Cmdlet die Netzwerksicherheitsgruppe festlegt, weist den Slot auf, den dieser Parameter angibt. Gültige Werte sind:

  • Produktion
  • Staging

Der Standardwert ist Production.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SubnetName

Gibt den Namen eines Subnetzes an, dem dieses Cmdlet die Netzwerksicherheitsgruppe zuordnet.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualNetworkName

Gibt den Namen eines virtuellen Netzwerks an, das das Subnetz enthält, dem dieses Cmdlet die Netzwerksicherheitsgruppe zuordnet.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VM

Gibt den virtuellen Computer an, auf den dieses Cmdlet die Netzwerksicherheitsgruppe anwendet.

Typ:PersistentVMRoleContext
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

Boolean